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Part I - Keyword Dictionary (continued) 


This section continues the alphabetical listing of HP BASIC keywords with a 
detailed syntax description for each. Refer to part II, “Reference Information,” 
in this volume for a summary of the keywords by category. 
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o 


OFF CDIAL 


Supported On 
Option Required 
Keyboard Executable 
Programmable 


In an IF ... THEN ... 


UX WS DOS 

KBD 

No 

Yes 

Yes 


This statement disables any ON CDIAL branching currently set up. 


(off cdial)-H 


Example Statements 

100 OFF CDIAL 

200 IF Done THEN OFF CDIAL 
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OFF CYCLE 


OFF CYCLE 


I 


Supported on 
Option Required 
Keyboard Executable 
Programmable 


[n an IF ... THEN ... 


UX WS DOS IN 

CLOCK 

No 

Yes 

Yes 


* 


This statement cancels event-initiated branches previously defined and enabled 
by an ON CYCLE statement. 


(off cycij^-H 


Example Statements 

OFF CYCLE 

IF Kick.stand THEN OFF CYCLE 

Semantics 

OFF CYCLE destroys the log of any CYCLE event which has already occurred 
but which has not been serviced. 

If OFF CYCLE is executed in a subprogram such that it cancels an ON 
CYCLE in the calling context, the ON CYCLE definition is restored upon 
returning to the calling context. 

BASIC/UX Specifics 

Resolution is 20 miliseconds. A new child process of BASIC/UX is started for 
the timer. 
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OFF DELAY 


Supported on 
Option Required 
Keyboard Executable 
Programmable 
In an IF ... THEN ... 


UX WS DOS 

CLOCK 

No 

Yes 

Yes 


This statement cancels event-initiated branches previously defined and enabled 
by an ON DELAY statement. 



Example Statements 

OFF DELAY 

IF Ready THEN OFF DELAY 

Semantics 

OFF DELAY destroys the log of any DELAY event which has already occurred 
but which has not been serviced. 

If OFF DELAY is executed in a subprogram such that it cancels an ON 
DELAY in the calling context, the ON DELAY definition is restored upon 
returning to the calling context. 

BASIC/UX Specifics 

Resolution is 20 milliseconds. A new child process of BASIC/UX is started for 
the timer. 
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OFF END 


OFF END 


I 


Supported On 
Option Required 
Keyboard Executable 
Programmable 


In an IF ... THEN ... 


UX WS DOS 

None 

No 

Yes 

Yes 


This statement cancels event-initiated branches previously enabled and defined 
by an ON END statement. 


Item 

Description 

Range 

I/O path name 

name assigned to a mass storage file 

any valid name (see 

ASSIGN) 


Example Statements 

OFF END CFile 

IF Special THEN OFF END fiSource 


Semantics 

If OFF END is executed in a subprogram and cancels an ON END in the 
context which called the subprogram, the ON END definitions are restored 
when the calling context is restored. 

If there is no ON END definition in a context, end-of-file and end-of-record are 
reported as errors. 
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OFF EOR 


Supported on 
Option Required 
Keyboard Executable 
Programmable 


In an IF ... THEN ... 


UX WS DOS 

TRANS 

No 

Yes 

Yes 


This statement cancels event-initiated branches previously defined and enabled 
by an ON EOR statement. 



Item Description Range 

I/O path name name assigned to a device, a group of any valid name 
devices, or a mass storage file 

Example Statements 

OFF EOR ©File 

OFF EOR ®Device_selector 

Semantics 

The I/O path may be assigned either to a device, a group of devices, or to a 
mass storage file or pipe; however, if the I/O path is assigned to a BUFFER, 
an error is reported when the OFF EOR statement is executed. 
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o 


OFF EOR 

OFF EOR destroys the log of any EOR event which has already occurred but 
which has not been serviced. 

If OFF EOR is executed in a subprogram such that it cancels an ON EOR in 
the calling context, the ON EOR definition is restored upon returning to the 
calling context. 
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OFF EOT 


Supported on 
Option Required 
Keyboard Executable 
Programmable 


In an IF ... THEN ... 


UX WS DOS 

TRANS 

No 

Yes 

Yes 


This statement cancels event-initiated branches previously defined and enabled 
by an ON EOT statement. 


( OFF EOT> -*(@T 


I/O path 
name 


Item 

Description 

Range 

I/O path name 

name assigned to a device, a group of 
devices, or a mass storage file 

any valid name 


Example Statements 

OFF EOT •File 

IF Done.flag THEN OFF EOT •Info 

Semantics 

The I/O path may be assigned either to a device, a group of devices, or to a 
mass storage file or pipe; however, if the I/O path is assigned to a BUFFER, 
an error is reported when the OFF EOT statement is executed. 

OFF EOT destroys the log of any EOT event which has already occurred but 
which has not been serviced. 

If OFF EOT is executed in a subprogram such that it cancels an ON EOT in 
the calling context, the ON EOT definition is restored upon returning to the 
calling context. 
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OFF ERROR 


OFF ERROR 


Supported On 
Option Required 
Keyboard Executable 
Programmable 
In an IF ... THEN ... 


UX WS DOS IN 

None 

No 

Yes 

Yes 


This statement cancels event-initiated branches previously defined and enabled 
by an ON ERROR statement. Further errors are reported to the user in the 
usual fashion. 
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OFF EXT SIGNAL 



o 


Supported On 
Option Required 
Keyboard executable 
Programmable 


In an IF ... THEN ... 


UX WS* DOS* 

None 

No 

Yes 

Yes 


This statement cancels event-initiated branches previously defined by an ON 
EXT SIGNAL statement. 


(off ext signal) 



H 


Item 

Description 

Range 

signal number 

numeric expression, rounded to 

1 through 32 (see ON EXT 


integer 

SIGNAL) 


Example Statements 

OFF EXT SIGNAL 4 
OFF EXT SIGNAL 

Semantics 

Not specifying a system signal number disables the event-initiated branches for 
all system signals. Specifying a signal number causes the OFF EXT SIGNAL 
to apply to the event-initiated log entry for the specified signal only. 

Any pending ON EXT SIGNAL branches for the affected signals are lost and 
further signals are vectored to the default handler for the EXT SIGNAL. 

See ON EXT SIGNAL for a description of the default actions for each EXT 
SIGNAL. 
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OFF EXT SIGNAL 

The action to be taken for an EXT SIGNAL is inherited when entering a new 
context (subprogram). This action stays in effect until an ON EXT SIGNAL 
or OFF EXT SIGNAL is executed. When an OFF EXT SIGNAL is executed 
within a context, the action for that external signal reverts to its default 
action. When the context is exited, the current action reverts to what it was in 
the calling context. 
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OFF HIL EXT 


Supported On 
Option Required 
Keyboard Executable 
Programmable 


In an IF ... THEN ... 


UX WS DOS 

KBD 

No 

Yes 

Yes 


This statement disables an end-of-line interrupt previously enabled by an ON 
HIL EXT statement. When this statement is executed, any pending ON HIL 
EXT branch is cancelled. 


C 


OFF HIL EXT 


> 


Example Statement 

OFF HIL EXT 

IF NOT Hil.active THEN OFF HIL EXT 
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OFF INTR 


OFF INTR 


Supported On 
Option Required 
Keyboard Executable 
Programmable 


In an IF ... THEN ... 


UX WS DOS IN 
10 
No 
Yes 
Yes 


This statement cancels event-initiated branches previously defined by an ON 
INTR statement. 



U 




interface 
select code 


■H 


Item 

Description 

Range 

interface select 
code 

numeric expression, rounded to an 
integer; Default = all interfaces 

5, and 7 through 31 


Example Statements 

OFF INTR 
OFF INTR Hpib 

Semantics 

Not specifying an interface select code disables the event-initiated branches 
for all interfaces. Specifying an interface select code causes the OFF INTR to 
apply to the event-initiated log entry for the specified interface only. 

Any pending ON INTR branches for the effected interfaces are lost and further 
interrupts are ignored. 
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OFF KBD 


Supported On 
Option Required 
Keyboard Executable 
Programmable 


In an IF ... THEN ... 


UX WS DOS 

None 

No 

Yes 

Yes 


This statement cancels the event-initiated branch previously defined by an ON 
KBD statement. 


(off kbd)-H 


Example Statements 

OFF KBD 

IF NOT Process.keys THEN OFF KBD 


Semantics 

When this statement is executed, any pending ON KBD branch is cancelled, 
and the keyboard buffer is cleared. 

If OFF KBD is executed in a subprogram such that it cancels an ON KBD 
in the calling context, the cancelled ON KBD definition is restored when the 
calling context is restored. However, the keyboard buffer’s contents are not 
restored with the calling context, because the buffer was cleared with the OFF 
KBD. 
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OFF KEY 

OFF KEY 

Supported On UX WS DOS IN 

Dption Required KBD 

Keyboard Executable No 

Programmable Yes 

[n an IF ... THEN ... Yes 

This statement cancels event-initiated branches previously defined and enabled 
3y an ON KEY statement. 



Item Description Range 

key selector numeric expression, rounded to an 0 through 19 
integer; Default = all keys 

Example Statements 

OFF KEY 
OFF KEY 4 

Semantics 

^ot specifying a softkey number disables the event-initiated branches for all 
loftkeys. Specifying a softkey number causes the OFF KEY to apply to the 
ipecified softkey only. If OFF KEY is executed in a subprogram and cancels an 
3N KEY in the context which called the subprogram, the ON KEY definitions 
ire restored when the calling context is restored. 

Vny pending ON KEY branches for the effected softkeys are lost. Pressing an 
mdefined softkey generates a beep. 
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OFF KNOB 


Supported On 
Option Required 
Keyboard Executable 
Programmable 


In an IF ... THEN ... 


UX WS DOS 

None 

No 

Yes 


Yes 


This statement cancels event-initiated branches previously defined and enabled 
by the ON KNOB statement. Any pending ON KNOB branches are lost. 
Further use of the knob will result in normal scrolling or cursor movement. 
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OFF SIGNAL 


OFF SIGNAL 


Supported On 
Option Required 
Keyboard Executable 
Programmable 


In an IF... THEN... 


UX WS DOS 
10 
No 
Yes 
Yes 


OFF SIGNAL cancels the ON SIGNAL definition with the same signal selector. 
If no signal selector is provided, all ON SIGNAL definitions are cancelled. OFF 
SIGNAL only applies to the current context. 


C 


OFF SIGNAL 






signal 

selector 


Item 

Description 

Range 

signal selector 

numeric expression, rounded to an 
integer 

0 through 15 


Example Statements 

OFF SIGNAL 
OFF SIGNAL 15 
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o 


OFF TIME 


Supported on 
Option Required 
Keyboard Executable 
Programmable 


In an IF ... THEN ... 


TJX WS DOS 

CLOCK 

No 

Yes 

Yes 


This statement cancels event-initiated branches previously defined and enabled 
by an ON TIME statement. 


(off 


Example Statements 

OFF TIME 

IF Attended THEM OFF TIME 

Semantics 

OFF TIME destroys the log of any TIME event which has already occurred 
but which has not been serviced. 

If OFF TIME is executed in a subprogram such that it cancels an ON TIME in 
the calling context, the ON TIME definition is restored upon returning to the 
calling context. 

BASIC/UX Specifics 

Resolution is 20 milliseconds. A new child process of BASIC/TJX is started for 
the timer. 
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OFF TIMEOUT 


OFF TIMEOUT 


I 


Supported on 
Option Required 
Keyboard Executable 
Programmable 


[n an IF ... THEN ... 


UX WS DOS IN 

None 

No 

Yes 

Yes 


This statement cancels event-initiated branches previously defined and enabled 
3y an ON TIMEOUT statement. 


C 


OFF TIMEOUT 


> 




interface 
select code 




Item 

Description 

Range 

interface select 
code 

numeric expression, rounded to an 
integer; Default = all interfaces 

7 through 31 


Example Statements 

OFF TIMEOUT 
OFF TIMEOUT Isc 

Semantics 

tfot specifying an interface select code disables the event-initiated branches for 
II interfaces. Specifying an interface select code causes the OFF TIMEOUT 
o apply to the event-initiated branches for the specified interface only. When 
)FF TIMEOUT is executed, no more timeouts can occur on the effected 
nterfaces. 
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OFF TIMEOUT 

BASIC/UX Specifics 

All channels of MUX interfaces have timeouts disabled by OFF TIMEOUT 
without an interface select code. 
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ON 


ON 


Supported On 
Option Required 
Keyboard Executable 
Programmable 


In an IF ... THEN ... 


UX WS DOS 

None 

No 

Yes 

Yes 


This statement transfers program execution to one of several destinations 
selected by the value of the pointer. 



Item 

Description 

Range 

pointer 

numeric expression, rounded to an 
integer 

1 through 74 

line number 

integer constant identifying a 
program line 

1 through 32 766 

line label 

name of a program line 

any valid name 


Example Statements 

ON XI GOTO 100,150,170 

IF Point THEN ON Point GOSUB First.Second,Third,Last 
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ON 

Semantics 

If the pointer is 1, the first line number or label is used. If the pointer is 2, the 
second line identifier is used, and so on. If GOSUB is used, the RETURN is to 
the line following the ON ... GOSUB statement. 

If the pointer is less than 1 or greater than the number of line labels or 
numbers, error 19 is generated. The specified line numbers or line labels must 
be in the same context as the ON statement. 
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ON CDIAL 


ON CDIAL 


Supported On 
Option Required 
Keyboard Executable 
Programmable 


In an IF ... THEN ... 


UX WS DOS 

KBD 

No 

Yes 

Yes 


This statement sets up and enables a branch to be taken upon sensing rotation 
of one of the dials on a “control dial” device. 



Item 

Description 

Range 

priority 

numeric expression, rounded to an 
integer; Default = 1 

1 through 15 

line label 

name of a program line 

any valid line name 

line number 

integer constant identifying a 
program line 

1 through 32 766 

subprogram 

name 

name of a SUB or CSUB subprogram 

any valid name 
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ON CDIAL 


Example Statements 

100 ON CDIAL GOSUB Dial_serv_rtn 
200 ON CDIAL,Priority CALL Dial_sub 


Semantics 

All CDIAL function registers are automatically cleared when ON CDIAL is 
executed. 

The interrupt service routine for the branch initiated when one of the control 
dials is rotated should read the number of pulses with the CDIAL function. 

If ON CDIAL is used to set up control dial interrupts and then disabled 
(with OFF CDIAL), the CDIAL function can still be used to determine valid 
information about control dials: however, note that subsequent pulses will not 
be accumulated into the CDIAL registers, and when a register is read with 
CDIAL, that register is automatically cleared by the system. 

The most recent ON CDIAL (or OFF CDIAL) overrides any previous ON 
CDIAL branching. If the overriding branch is defined in another context (such 
as in a SUB subprogram or user-defined FN), then the overriding branch is 
canceled and the overridden branch is restored upon return to the calling 
context. 

The ON CDIAL statement behaves like the ON KNOB and ON HIL EXT 
statements: 

■ When ON CDIAL is executed in a SUB context and program control exits 
that context, the pulses from control dials will continue to be accumulated 
(and can be read by CDIAL). No interrupts occur if there is no ON CDIAL 
active in the current context. 

■ Conversely, if an ON CDIAL has been executed in a context and then OFF 
CDIAL is executed in a called context, then upon returning to the calling 
context the pulses will be routed to the BASIC system (instead of the 
CDIAL function) and no interrupts will be initiated. 

The priority can be specified, with the highest represented by a value of 
15. (This is the highest user-specifiable priority; however, ON END and 
ON TIMEOUT have priorities of 16, and ON ERROR has a priority of 
17.) An ON CDIAL branch can interrupt the currently executing program 
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0 


ON CDIAL 

segment, if its priority is higher than the current SYSTEM PRIORITY (use 
SYSTEM!("SYSTEM PRIORITY") to determine the current priority). 

Upon completion of the interrupt service routine, CALL and GOSUB branches 
are returned to the next line that would have been executed if the ON CDIAL 
branch had not been serviced; the system priority is returned to the value in 
effect before the ON CDIAL branch occurred. RECOVER forces the program 
to go directly to the specified line in the context containing the ON CDIAL 
statement; when RECOVER forces a change of context, the system priority is 
restored to the value which existed in the original (defining) context at the 
time that the context was exited. 

CALL and RECOVER remain active (that is, they can initiate branches) when 
the context changes to a subprogram (SUB), unless the change in context 
is caused by a keyboard-originated CALL statement. GOSUB and GOTO 
remain active when the context changes to a subprogram, but the branch is not 
initiated until after the calling context is restored. 

ON CDIAL branches are disabled by DISABLE, temporarily disabled when the 
program is executing an INPUT, LINPUT, or ENTER KBD ... statement; 
and deactivated by OFF CDIAL. 

ON CDIAL does not initiate branches for other “knob” devices (such as 
built-in knobs of 98203 keyboards or HIL mouse devices). 
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ON CYCLE 


Supported on 


Option Required 
Keyboard Executable 
Programmable 


In an IF ... THEN ... 


UX WS DOS IN* 

CLOCK 

No 

Yes 


Yes 


This statement defines and enables an event-initiated branch to be taken each 
time the specified number of seconds has elapsed. 



Item Description Range 


seconds 

numeric expression, rounded to the 
nearest 0.02 second 

0.01 through 167 772.16 

priority 

numeric expression, rounded to an 
integer; Default=l 

1 through 15 

line label 

name of a program line 

any valid name 

line number 

integer constant identifying a 
program line 

1 through 32 766 

subprogram 

name 

name of a SUB or CSUB subprogram 

any valid name 
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o 


ON CYCLE 

Example Statements 

OH CYCLE 1 GOSUB One.second 
ON CYCLE 3600,12 CALL Chime 

Semantics 

The most recent ON CYCLE (or OFF CYCLE) definition overrides any 
previous ON CYCLE definition. If the overriding ON CYCLE definition occurs 
in a context different from the one in which the overridden ON CYCLE occurs, 
the overridden ON CYCLE is restored when the calling context is restored, 
but the time value of the more recent ON CYCLE remains in effect. For more 
information on the behavior of ON CYCLE in different contexts, read the 
section “Branching Restrictions” in the chapter “Using the Clock and Timers” 
in the HP BASIC 6.2 Programming Guide manual. 

The priority can be specified, with the highest priority represented by 15. The 
highest user-defined priority (15) is less than the priority for ON ERROR, 

ON END, and ON TIMEOUT (whose priorities are not user-definable). ON 
CYCLE can interrupt service routines of other event-initiated branches with 
user-definable priorities, if the ON CYCLE priority is higher than the priority 
of the service routine (the current system priority). CALL and GOSUB service 
routines get the priority specified in the ON ... statement which set up the 
branch that invoked them. The system priority is not changed when a GOTO 
branch is taken. 

Any specified line label or line number must be in the same context as the ON 
CYCLE statement. CALL and GOSUB will return to the next line that would 
have been executed if the CYCLE event had not been serviced, and the system 
priority is restored to that which existed before the ON CYCLE branch was 
taken. RECOVER forces the program to go directly to the specified line in the 
context containing that ON CYCLE statement. When RECOVER forces a 
change of context, the system priority is restored to that which existed in the 
original (defining) context at the time that context was exited. 

CALL and RECOVER remain active when the context changes to a 
subprogram, unless the change in context is caused by a keyboard-originated 
call. GOSUB and GOTO remain active when the context changes to a 
subprogram, but the branch cannot be taken until the calling context is 
restored. 
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ON CYCLE 

ON CYCLE is disabled by DISABLE and deactivated by OFF CYCLE. If the 
cycle value is short enough that the computer cannot service it, the interrupt 
will be lost. 

BASIC/UX Specifics 

Resolution is 20 milliseconds. A new child process of BASIC/UX is started for 
the timer. 
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ON DELAY 


ON DELAY 


Supported on 
Option Required 
Keyboard Executable 
Programmable 


In an IF... THEN... 


UX WS DOS 

CLOCK 

No 

Yes 

Yes 


This statement defines and enables an event-initiated branch to be taken after 
the specified number of seconds has elapsed. 



Item 

Description 

Range 

seconds 

numeric expression, rounded to the 
nearest 0.02 second 

0.01 through 167 772.16 

priority 

numeric expression, rounded to an 
integer; Default=l 

1 through 15 

line label 

name of a program line 

any valid name 

line number 

integer constant identifying a 
program line 

1 through 32 766 

subprogram 

name 

name of a SUB or CSUB subprogram 

any valid name 
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ON DELAY 

Examples 

ON DELAY 10 GOTO Default 
ON DELAY 3,2 GOSUB Low.level 


Semantics 

The most recent ON DELAY (or OFF DELAY) definition overrides any 
previous ON DELAY definition. If the overriding ON DELAY definition occurs 
in a context different from the one in which the overridden ON DELAY occurs, 
the overridden ON DELAY is restored when the calling context is restored, 
but the time value of the more recent ON DELAY remains in effect. For more 
information on the behavior of ON DELAY in different contexts, read the 
section “Branching Restrictions” in the chapter “Using the Clock and Timers” 
in the HP BASIC 6.2 Programming Guide. 

The priority can be specified, with the highest priority represented by 15. The 
highest user-defined priority (15) is less than the priority for ON ERROR, 

ON END, and ON TIMEOUT (whose priorities are not user-definable). ON 
DELAY can interrupt service routines of other event-initiated branches with 
user-definable priorities, if the ON DELAY priority is higher than the priority 
of the service routine (the current system priority). CALL and GOSUB service 
routines get the priority specified in the ON ... statement which set up the 
branch that invoked them. The system priority is not changed when a GOTO 
branch is taken. 

Any specified line label or line number must be in the same context as the ON 
DELAY statement. CALL and GOSUB will return to the next line that would 
have been executed if the DELAY event had not been serviced, and the system 
priority is restored to that which existed before the ON DELAY branch was 
taken. RECOVER forces the program to go directly to the specified line in the 
context containing that ON DELAY statement. When RECOVER forces a 
change of context, the system priority is restored to that which existed in the 
original (defining) context at the time that context was exited. 

CALL and RECOVER remain active when the context changes to a 
subprogram, unless the change in context is caused by a keyboard-originated 
call. GOSUB and GOTO remain active when the context changes to a 
subprogram, but the branch cannot be taken until the calling context is 
restored. 
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ON DELAY 

ON DELAY is disabled by DISABLE and deactivated by OFF DELAY. 

BASIC/UX Specifics 

Resolution is 20 milliseconds. A new child process of BASIC/UX is started for 
the timer. 


OFF CDIAL ■ OUTPUT 0-31 



ON END 


o 


Supported On 
Option Required 
Keyboard Executable 
Programmable 


In an IF ... THEN ... 


UX WS DOS 

None 

No 

Yes 

Yes 


This statement defines and enables an event-initiated branch to be taken when 
end-of-file is reached on the mass storage file associated with the specified I/O 
path. 


C 


ON END 



Item 

Description 

Range 

I/O path name 

name assigned to a mass storage file 

any valid name (see 

ASSIGN) 

line label 

name of a program line 

any valid name 

line number 

integer constant identifying a 
program line 

1 through 32 766 

subprogram 

name 

name of a SUB or CSUB subprogram 

any valid name 
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ON END 

Example Statements 

ON END QSource GOTO Nert.file 
ON END QDest CALL Expand 

Semantics 

The ON END branch is triggered by any of the following events: 

■ When the physical end-of-file is encountered. 

■ When an ENTER statement reads the byte at EOF or beyond. 

■ When a random access OUTPUT or ENTER requires more than one defined 
record. 

■ When a random access OUTPUT is attempted beyond the next available 
record. (If EOF is the first byte of a record, then that record is the next 
available record. If EOF is not at the first byte of a record, the following 
record is the next available record.) 

The priority associated with ON END is higher than priority 15. ON 
TIMEOUT and ON ERROR have the same priority as ON END, and can 
interrupt an ON END service routine. 

Any specified line label or line number must be in the same context as the 
ON END statement. CALL and GOSUB will return to the line immediately 
following the one during which the end-of-file occurred, and the system 
priority is restored to that which existed before the ON END branch was 
taken. RECOVER forces the program to go directly to the specified line in the 
context containing that ON END statement. When RECOVER forces a change 
of context, the system priority is restored to that which existed in the original 
(defining) context was exited. 

CALL and RECOVER remain active when the context changes to a 
subprogram, if the I/O path name is known in the new context. CALL 
and RECOVER do not remain active if the context changes as a result of a 
keyboard-originated call. GOSUB and GOTO do not remain active when the 
context changes to a subprogram. 

The end-of-record error (error 60) or the end-of-file error (error 59) can be 
trapped by ON ERROR if ON END is not active. ON END is deactivated by 
OFF END. DISABLE does not affect ON END. 
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ON EOR 


Supported on 
Option Required 
Keyboard Executable 
Programmable 


In an IF ... THEN ... 


UX WS DOS 

TRANS 

No 

Yes 

Yes 


This statement defines and enables an event-initiated branch to be taken when 
an end-of-record is encountered during a TRANSFER. 



Item 

Description 

Range 

I/O path name 

name assigned to a device, a group of 
devices, or a mass storage file 

any valid name 

priority 

numeric expression, rounded to an 
integer; Default=l 

1 through 15 

line label 

name of a program line 

any valid name 

line number 

integer constant identifying a 
program line 

1 through 32 766 

subprogram 

name 

name of a SUB or CSUB subprogram 

any valid name 


0-34 OFF CDIAL - OUTPUT 









ON EOR 


Example Statements 

OH EOR CGpio GOSUB Gpio_eor 
ON EOR QHpib,9 CALL Eor.sensed 



Semantics 

The I/O path may be assigned either to a device, a group of devices, or to a 
mass storage file or pipe. If the I/O path is assigned to a BUFFER, an error is 
reported when the ON EOR statement is executed. 

If a TRANSFER statement uses an I/O path name which is local to a 
subprogram and the TRANSFER has not completed by the time the context 
is exited, returning to the original context will be deferred until the end of the 
TRANSFER; at that time the ON EOR event cannot be serviced. To ensure 
that the event will be serviced, a statement that cannot be executed in overlap 
with the TRANSFER must be executed before the context is exited. A WAIT 
FOR EOR QNon.buf statement is used for this purpose. 

End-of-record delimiters are defined by the EOR parameters of the 
TRANSFER statement (i.e., DELIM, COUNT, or END). An EOR event 
occurs when any of the specified end-of-record delimiters is encountered during 
a TRANSFER. The event’s occurrence is logged, and the specified branch is 
taken when system priority permits. 

The most recent ON EOR (or OFF EOR) definition for a given I/O path 
name overrides any previous ON EOR definition. If the overriding ON EOR 
definition occurs in a context different from the one in which the overridden 
ON EOR occurs, the overridden ON EOR is restored when the calling context 
is restored. 

The priority can be specified, with the highest priority represented by 15. The 
highest user-defined priority (15) is less than the priority for ON ERROR, 

ON END, and ON TIMEOUT (whose priorities are not user-definable). ON 
EOR can interrupt service routines of other event-initiated branches with 
user-definable priorities, if the ON EOR priority is higher than the priority of 
the service routine (the current system priority). CALL and GOSUB service 
routines get the priority specified in the ON ... statement which set up the 
branch that invoked them. The system priority is not changed when a GOTO 
branch is taken. 
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Any specified line label or line number must be in the same context as the ON 
EOR statement. CALL and GOSUB will return to the next line that would 
have been executed if the EOR event had not been serviced, and the system 
priority is restored to that which existed before the ON EOR branch was 
taken. RECOVER forces the program to go directly to the specified line in the 
context containing that ON EOR statement. When RECOVER forces a change 
of context, the system priority is restored to that which existed in the original 
(defining) context at the time that context was exited. 

CALL and RECOVER remain active when the context changes to a 
subprogram, unless the change in context is caused by a keyboard-originated 
call. GOSUB and GOTO remain active when the context changes to a 
subprogram, but the branch cannot be taken until the calling context is 
restored. 

ON EOR is disabled by DISABLE and deactivated by OFF EOR. 
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ON EOT 


Supported on 
Option Required 
Keyboard Executable 
Programmable 


In an IF ... THEN ... 


UX WS DOS 

TRANS 

No 

Yes 

Yes 


This statement defines and enables an event-initiated branch to be taken when 
the last byte is transferred by a TRANSFER statement. 



Item 

Description 

Range 

I/O path name 

name assigned to a device, a group of 
devices, or a mass storage file 

any valid name 

priority 

numeric expression, rounded to an 
integer; Default=l 

1 through 15 

line label 

name of a program line 

any valid name 

line number 

integer constant identifying a 
program line 

1 through 32 766 

subprogram 

name 

name of a SUB or CSUB subprogram 

any valid name 
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Example Statements 

ON EOT CFile GOTO Finished 
ON EOT «Hpib,5 CALL More 

Semantics 

The I/O path may be assigned either to a device, a group of devices, or to a 
mass storage file or pipe. If the I/O path is assigned to a BUFFER, an error is 
reported when the ON EOT statement is executed. 

If a TRANSFER statement uses an I/O path name which is local to a 
subprogram and the TRANSFER has not completed by the time the context 
is exited, returning to the original context will be deferred until the end of the 
TRANSFER; at that time the ON EOT event cannot be serviced. To ensure 
that the event will be serviced, a statement that cannot be executed in overlap 
with the TRANSFER must be executed before leaving the context. A WAIT 
FOR EOT @Non_buf statement is used for this purpose. 

The most recent ON EOT (or OFF EOT) definition for a given path name 
overrides any previous ON EOT definition. If the overriding ON EOT 
definition occurs in a context different from the one in which the overridden 
ON EOT occurs, the overridden ON EOT is restored when the calling context 
is restored. 

The priority can be specified, with the highest priority represented by 15. The 
highest user-defined priority (15) is less than the priority for ON ERROR, 

ON END, and ON TIMEOUT (whose priorities are not user-definable). ON 
EOT can interrupt service routines of other event-initiated branches with 
user-definable priorities, if the ON EOT priority is higher than the priority of 
the service routine (the current system priority). CALL and GOSUB service 
routines get the priority specified in the ON ... statement which set up the 
branch that invoked them. The system priority is not changed when a GOTO 
branch is taken. 

Any specified line label or line number must be in the same context as the ON 
EOT statement. CALL and GOSUB will return to the next line that would 
have been executed if the EOT event had not been serviced, and the system 
priority is restored to that which existed before the ON EOT branch was 
taken. RECOVER forces the program to go directly to the specified line in the 
context containing that ON EOT statement. When RECOVER forces a change 
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of context, the system priority is restored to that which existed in the original 
(defining) context at the time that context was exited. 

CALL and RECOVER remain active when the context changes to a 
subprogram, unless the change in context is caused by a keyboard-originated 
call. GOSUB and GOTO remain active when the context changes to a 
subprogram, but the branch cannot be taken until the calling context is 
restored. 

ON EOT is disabled by DISABLE and deactivated by OFF EOT. 
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ON ERROR 


Supported On 
Option Required 
Keyboard Executable 
Programmable 


In an IF ... THEN ... 


UX WS DOS IN 

None 

No 

Yes 

Yes 


This statement defines and enables an event-initiated branch which results 
from a trappable error. This allows you to write your own error-handling 
routines. 



Item 

Description 

Range 

line label 

name of a program line 

any valid name 

line number 

integer constant identifying a 
program line 

1 through 32 766 

subprogram 

name of a SUB or CSUB subprogram 

any valid name 

name 




Example Statements 

ON ERROR GOTO 1200 
ON ERROR CALL Report 
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Semantics 

The ON ERROR statement has the highest priority of any event-initiated 
branch. ON ERROR can interrupt any event-initiated service routine. 

Any specified line label or line number must be in the same context as the 
ON ERROR statement. RECOVER forces the program to go directly to the 
specified line in the context containing the ON ERROR statement. 

Returns via RETURN, SUBEXIT, or SUBEND from ON ERROR GOSUB 
or ON ERROR CALL routines are different from regular GOSUB or CALL 
returns. When ON ERROR is in effect, the program resumes at the beginning 
of the line where the error occurred. If the ON ERROR routine did not correct 
the cause of the error, the error is repeated. This causes an infinite loop 
between the line in error and the error handling routine. To avoid a retry of 
the line which caused the error, use ERROR RETURN instead of RETURN 
or ERROR SUBEXIT instead of SUBEXIT. When execution returns from the 
ON ERROR routine, system priority is restored to that which existed before 
the ON ERROR branch was taken. 

CALL and RECOVER remain active when the context changes to a 
subprogram, unless the change in context is caused by a keyboard-originated 
call. In this case, the error is reported to the user, as if ON ERROR had not 
been executed. 

GOSUB and GOTO do not remain active when the context changes to a 
subprogram. If an error occurs, the error is reported to the user, as if ON 
ERROR had not been executed. 

If an execution error occurs while servicing an ON ERROR CALL or ON 
ERROR GOSUB, program execution stops. If an execution error occurs while 
servicing an ON ERROR GOTO or ON ERROR RECOVER routine, an 
infinite loop can occur between the line in error and the GOTO or RECOVER 
routine. 

If an ON ERROR routine cannot be serviced because inadequate memory is 
available for the computer, the original error is reported and program execution 
pauses at that point. 

ON ERROR is deactivated by OFF ERROR. DISABLE does not affect ON 
ERROR. 
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Supported On 
Option Required 
Keyboard executable 
Programmable 


In an IF ... THEN ... 


UX WS* 

n/a 

No 

Yes 

Yes 


DOS 


* 


This statement defines an event-initiated branch to be taken when a system 
generated signal is received. 


0 


ON EXT SIGNAL 


iH 


signal 

number 


priority ^ 


GOTO y 


GOSUB 


Hj 


>1 


RECOVER 


line label 


line nurnbei 


CALL )- 



subprogram 

j 


nom« 



Item 

Description 

Range 

signal number 

numeric expression, rounded to 
integer 

(see below) 

priority 

numeric expression, rounded to 
integer (Default = 1) 

1 through 15 

line label 

name of a program line 

any valid name 

line number 

integer const identifying a program 
line 

1 through 32 766 

subprogram 

name 

name of a SUB or CSUB 

any valid name 
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Example Statements 

OH EXT SIGNAL 4 GOTO 10 

ON EXT SIGNAL Sigusr2,12 GOSUB Fred 

ON EXT SIGNAL Sigterm,15 CALL Terminate 

Semantics 

The ON EXT SIGNAL statement specifies a new action to be taken when 
l system generated signal is received by BASIC. If an ON EXT SIGNAL 
tatement is not specified, then a default system action is be taken. The action 
or a specific EXT SIGNAL is specified in the table below. The two possible 
ictions that can be taken are: 

Dxit BASIC is immediately, but gracefully exited. 

irror An error [number to be determined] is generated at the next 

end-of-line. 

ill ON EXT SIGNAL actions take place at end-of-line except the default 
,ction to exit, which takes effect immediately upon receipt. 

1ASIC does not allow all system signals to be caught by users. The table 
>elow specifies all system signals, and indicates which can be specified in the 
SXT SIGNAL statements. All other values cause an error. This table also 
pecifies the default EXT SIGNAL handling action which takes place in the 
bsence of an ON EXT SIGNAL, or after an OFF EXT SIGNAL. 
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Signal 

Number 

Signal 

Name 

Valid 

Signal 

Default 

Action 

Comment 

1 

SIGHUP 

yes 

exit 

hangup (lost connection) 

2 

SIGINT 

no 

- 

BASIC “CLR-I/O” signal 

3 

SIGQUIT 

no 

- 

BASIC “RESET” signal 

4 

SIGILL 

no 

- 

illegal instruction 

5 

SIGTRAP 

no 

- 

BASIC debugging signal 

6 

SIGIOT 

yes 

error 

software generated (abort) 

7 

SIGEMT 

yes 

error 

software generated 

8 

SIGFPE 

no 

- 

floating point execution used 
internally by BASIC 

9 

SIGKILL 

no 

- 

not catchable by anyone 

10 

SIGBUS 

no 

- 

hardware bus error 

11 

SIGSEGV 

no 

- 

segmentation violation 

12 

SIGSYS 

yes 

error 

bad argument to system call 

13 

SIGPIPE 

no 

- 

write on pipe with no reader 

14 

SIGALRM 

yes 

error 

system alarm clock (used by 
BASIC) 

15 

SIGTERM 

yes 

exit 

software termination signal 

16 

SIGUSR1 

no 

- 

used by BASIC for 
communications 

17 

SIGUSR2 

yes 

error 

user defined signal 

18 

SIGCLD 

no 

- 

used by BASIC 

19 

SIGPWR 

no 

- 

powerfail; never reaches user 

20 

SIGVTALRM 

yes 

error 

virtual timer alarm 
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Signal 

Number 

Signal 

Name 

Valid 

Signal 

Default 

Action 

Comment 

21 

SIGPROF 

yes 

error 

profiling timer alarm 

22 

SIGIO 

yes 

error 

I/O possible signal 

23 

SIGWINDOW 

no 

- 

window/mouse signal 

24 

SIGSTOP 

no 

- 

sendable stop signal not 
from tty 

25 

SIGTSTP 

no 

- 

stop signal from tty 

26 

SIGCONT 

no 

- 

continue a stopped process 

27 

SIGTTIN 

no 

- 

to readers pgroup upon 
background tty read 

28 

SIGTTOU 

no 

- 

like TTIN for output 

29 

SIGURG 

no 

- 

urgent condition on I/O 
channel 

30 

SIGLOST 

no 

- 

remote lock lost (NFS) 

31 

- 

no 

- 

not defined for HP-UX 

32 

SIGDIL 

no 

- 

DIL signal 


EXT SIGNALS default to and remain enabled unless explicitly disabled with 
the DISABLE EXT SIGNAL statement. 

The priority of an EXT SIGNAL can be specified in the ON EXT SIGNAL 
statement, with the highest priority represented by 15. The highest priority 
is less than the priority for ON ERROR, ON END, and ON TIMEOUT. ON 
EXT SIGNAL can interrupt service routines of other event-initiated branches 
which have user-definable priorities, if the ON EXT SIGNAL priority is higher 
than the priority of the service routine (the current system priority). CALL 
and GOSUB service routines get the priority specified in the ON ... statement 
which set up the branch that invoked them. The system priority is not changed 
when a GOTO branch is taken. 

Any specified line label or line number must be in the same context as the ON 
EXT SIGNAL statement. CALL and GOSUB return to the next line that 
would have been executed if the EXT SIGNAL event had not been serviced, 
and the system priority is restored to that which existed before the ON EXT 
SIGNAL branch was taken. RECOVER forces the program to go directly to 
the specified line in the context containing that ON EXT SIGNAL statement. 
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When recover forces a change of context, the system priority is restored to that 
which existed in the original (defining) context at the time that context was 
exited. 

CALL and RECOVER remain active when the context changes to a 
subprogram, unless the change in context is caused by a keyboard-originated 
call. GOSUB and GOTO remain active when the context changes to a 
subprogram, but the branch cannot be taken until the calling context is 
restored. 

ON EXT SIGNAL is disabled by DISABLE EXT SIGNAL or DISABLE and 
deactivated by OFF EXT SIGNAL. 

The current state of the system signal handling can be determined through 
the STATUS statement. EXT SIGNALS use the pseudo-select code 33 for 
providing status information. For each EXT SIGNAL, a status register exists 
with the same number, and providing the following information: 


Status 

Number 

Comment 

-1 

signal not catchable by user 

0 

signal disabled 

1 

signal enabled 


Thus to determine the state of the SIGTERM (15) signal, 

STATUS 33,15;A 

When an EXT SIGNAL is enabled, and there is no ON EXT SIGNAL setup 
for it and the default action is an error , a program error is generated if a 
program is running, or if in a keyboard command (including EXECUTE). If a 
program is running, an ON ERROR statement can catch the error. 

When BASIC is idle (not running a program and not executing a keyboard 
command) all EXT SIGNALS except SIGHUP and SIGTERM are ignored. 
SIGHUP and SIGTERM exit if they are enabled. 

Note that all EXT SIGNALS default to being enabled. 
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ON HIL EXT 


I 


Supported On 
Option Required 
Keyboard Executable 
Programmable 


In an IF ... THEN ... 


UX WS DOS 

KBD 

No 

Yes 

Yes 


This statement enables an end-of-line interrupt in response to receiving data 
from HIL devices whose poll records are not otherwise being processed by the 
BASIC system. 



Item 

Description /Default 

Range 

Restrictions 

address mask 

the sum of 2 raised to the power of each 
of the addresses of the desired devices; 
Default = 254 

any even number 
from 2 to 254 

priority 

numeric expression, rounded to a 
integer ;Default = 1 

1 through 15 

line label 

name of a program line 

any valid name 

line number 

integer constant identifying a program 
line 

1 through 32 766 

subprogram 

name 

name of a SUB or CSUB subprogram 

any valid name 
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Example Statement 

ON HIL EXT 8 GOSUB Ser.routine 

ON HIL EXT Mask,Priority CALL Sub.prog 

ON HIL EXT 2,3 GOTO Label.l 

Semantics 

The address mask provides the capability of being able to enable polling of 
several devices using the same ON HIL EXT statement. This mask is obtained 
by raising 2 to the power of each of the addresses of desired devices, and 
adding these values. Suppose you want to create a mask which would allow 
interrupts from HP-HIL devices at addresses 1 and 3. You would take 2 and 
raise it to the first power and add this result to 2 raised to the third power; 
the final result is a mask value of 10. This indicates that end-of-line interrupts 
can be received from HP-HIL devices at addresses 1 and 3 in the HP-HIL link. 
Note that the default mask is 254 (all devices in the link). 

While interrupts are enabled, poll records are accumulated and returned via 
the HILBUFS function. If the HIL SEND statement results in data being 
returned from the device, the data is put into HILBUFS even if HP-HIL 
interrupts are not enabled (i.e. ON HIL EXT is not currently active). Note 
that no interrupt is generated, even if HP-HIL interrupts are enabled (i.e. ON 
HIL EXT is currently active), for data placed in HILBUFS as a result of HIL 
SEND. However, care should be taken in this case, since executing ON HIL 
EXT clears HILBUFS. 

HP-HIL devices which can use the ON HIL EXT statement are those whose 
poll records are not being processed for another purpose by the BASIC system 
or the Keyboard controller. These devices are grouped into two categories: 

■ Absolute positioning devices which are not the current GRAPHICS INPUT 
device. Examples of these devices are as follows: Touchscreen (HP 35723A), 
A-size Digitizer (HP 46087A), B-size Digitizer (HP 46088A). Note that both 
digitizers return data too fast to be processed using the HILBUFS function; 
therefore, it is best to use the GRAPHICS INPUT IS statement with these 
devices along with the READ LOCATOR or DIGITIZE statement. 

■ HP-HIL devices with Device ID’s less than hexadecimal 60. Examples of 
these devices are as follows: Bar-code Reader (HP 92916A), ID Module (HP 
46084A), Function Box (HP 46086A), Vectra Keyboard (HP 46030A). 
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The main HP-HIL devices which cannot use this function are: 

■ Relative pointing devices, such as the HP Mouse (HP 46060A) and Control 
Dial Box (HP 46085A). Since the HP 98203C keyboard has a knob on it, it is 
considered a relative pointing device. 

■ Current GRAPHICS INPUT devices. 

■ All system Keyboards (includes HP 98203C as well as HP 46020/21A). Their 
poll records are processed by the Keyboard controller and the keycodes 
returned to BASIC via a different interface. 

The priority can be specified, with the highest priority represented by 15. The 
highest user-defined priority (15) is less than the priority for ON ERROR, 

ON END, and ON TIMEOUT (whose priorities are not user-definable). ON 
HIL EXT can interrupt service routines of other event-initiated branches with 
user-definable priorities, if the ON HIL EXT priority is higher than the priority 
of the service routine (the current system priority). CALL and GOSUB service 
routines get the priority specified in the ON ... statement which set up the 
branch that invoked them. The system priority is not changed when a GOTO 
branch is taken. 

Any specified line label or line number must be in the same context as the 
ON HIL EXT statement. CALL and GOSUB will return to the next line 
that would have been executed if the HIL EXT event had not been serviced, 
and the system priority is restored to that which existed before the ON HIL 
EXT branch was taken. RECOVER forces the program to go directly to the 
specified line in the context containing the ON HIL EXT statement. When 
RECOVER forces a change of context, the system priority is restored to that 
which existed in the original (defining) context at the time that context was 
exited. 

CALL and RECOVER remain active when the context changes to a 
subprogram, unless the change in context is caused by a keyboard-originated 
call. GOSUB and GOTO remain active when the context changes to a 
subprogram, but the branch cannot be taken until the calling context is 
restored. 

The most recent ON HIL EXT (or OFF HIL EXT) overrides any previous ON 
HIL EXT definition. If the overriding ON HIL EXT occurs in another context 
(such as in a SUB subprogram), then the overridden ON HIL EXT branch is 
restored when the calling context is restored. (See below for restrictions.) 
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ON HIL EXT is deactivated by OFF HIL EXT. 

The ON HIL EXT statement behaves like the ON CDIAL and ON KNOB 
statements: 

■ When ON HIL EXT is executed in a SUB context and program control 
exits that context, the data from the enabled devices will continue to be 
accumulated (and can be read by HILBUF$—unless lost due to buffer 
overflow). No interrupts occur if there is no ON HIL EXT active in the 
current context. 

■ Conversely, if an ON HIL EXT has been executed in a context and the 
OFF HIL EXT is executed in a called context, upon returning to the calling 
context, the data is not accumulated for HILBUF$ and no interrupts will be 
initiated. 

If ON HIL EXT is executed in a context with one mask value, and then 
another ON HIL EXT is executed in a called context with a different mask 
value, the former mask value is not restored on return to the calling context. 
This behavior is similar to the time parameters of ON CYCLE and ON 
DELAY. 
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3N INTR 

Supported On UX WS DOS IN 

Option Required 10 

keyboard Executable No 

Programmable Yes 

n an IF ... THEN ... Yes 

This statement defines an event-initiated branch to be taken when an interface 
:ard generates an interrupt. The interrupts must be explicitly enabled with an 
UNABLE INTR statement. 



Item Description Range 


interface select 

numeric expression, rounded to an 

5, 7 through 31 

code 

integer 


priority 

numeric expression, rounded to an 
integer; Default=l 

1 through 15 

line label 

name of a program line 

any valid name 

line number 

integer constant identifying a 
program line 

1 through 32 766 

subprogram 

name of a SUB or CSUB subprogram 

any valid name 

name 

1 
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Example Statements 

ON INTR 7 GOSUB 500 
ON INTR Isc,4 CALL Service 


Semantics 

The occurrence of an interrupt performs an implicit DISABLE INTR for the 
interface. An ENABLE INTR must be performed to re-enable the interface for 
subsequent event-initiated branches. Another ON INTR is not required, nor 
must the mask for ENABLE INTR be redefined. 

The priority can be specified, with highest priority represented by 15. The 
highest priority is less than the priority for ON ERROR, ON END, and ON 
TIMEOUT. ON INTR can interrupt service routines of other event-initiated 
branches which have user-definable priorities, if the ON INTR priority is higher 
than the priority of the service routine (the current system priority). CALL 
and GOSUB service routines get the priority specified in the ON ... statement 
which set up the branch that invoked them. The system priority is not changed 
when a GOTO branch is taken. 

Any specified line label or line number must be in the same context as the ON 
INTR statement. CALL and GOSUB will return to the next line that would 
have been executed if the INTR event had not been serviced, and the system 
priority is restored to that which existed before the ON INTR branch was 
taken. RECOVER forces the program to go directly to the specified line in 
the context containing that ON INTR statement. When RECOVER forces a 
change of context, the system priority is restored to that which existed in the 
original (defining) context at the time that context was exited. 

CALL and RECOVER remain active when the context changes to a 
subprogram, unless the change in context is caused by a keyboard-originated 
call. GOSUB and GOTO remain active when the context changes to a 
subprogram, but the branch cannot be taken until the calling context is 
restored. 

ON INTR is disabled by DISABLE INTR or DISABLE and deactivated by 
OFF INTR. 

ON INTR and OFF INTR statements may be executed for any I/O card in the 
machine. It is not necessary to have a driver for the card. 
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ON KBD 


Supported On 
Option Required 
Keyboard Executable 
Programmable 


In an IF ... THEN ... 


UX WS DOS 

None 

No 

Yes 

Yes 


This statement defines and enables an event-initiated branch to be taken when 
a, key is pressed. 



Item 

Description 

Range 

priority 

numeric expression, rounded to an 
integer; Default = 1 

1 through 15 

line label 

name of a program line 

any valid name 

line number 

integer constant identifying a 
program line 

1 through 32 766 

subprogram 

name 

name of a SUB or CSUB subprogram 

any valid name 
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Example Statements 

ON KBD GOSUB 770 
ON KBD,9 CALL Get_key 

Semantics 

Specifying the secondary keyword ALL causes all keys except ( reset 1 , (shift 1 , 
and (ctrl! to be trapped. When ALL is omitted, the untrapped keys are those 
just mentioned, the softkeys, [PAUSE] , [stop] , (CLR I/O] , fBreak] , (System] , [User] , 
(Menu ] , and [shift] (Menu ] . When not trapped, these keys perform their normal 
functions. When the softkeys are trapped, ON KBD branching overrides any 
ON KEY branching. 

A keystroke triggers a keyboard interrupt and initiates a branch to the 
specified routine when priority allows. If keystrokes occur while branching 
is held off by priority, the keystrokes are stored in a special buffer. When 
keystrokes are in the buffer, branching will occur when priority allows. This 
buffer is read and cleared by the KBD$ function (see the KBD$ entry). 

Knob rotation will generate ON KBD interrupts unless an ON KNOB 
statement has been executed. Clockwise rotation of the knob produces 
right-arrow keystrokes; counterclockwise rotation produces left-arrow keystokes. 
If the (shift] key is pressed while turning the knob, then clockwise rotation of 
the knob produces up-arrow keystrokes; counterclockwise rotation produces 
down-arrow key strokes. Since one rotation of the knob is equivalent to 20 
keystrokes (more with HP-HIL knobs), keyboard buffer overflow may occur if 
the BASIC service routine does not process the keys rapidly. 

Live keyboard, editing, and display control functions are suspended during ON 
KBD. To restore a key’s normal function the keystroke may be OUTPUT to 
select code 2. 

The most recent ON KBD (or OFF KBD) definition overrides any previous 
ON KBD definition. If the overriding ON KBD definition occurs in a context 
different from the one in which the overridden ON KBD occurs, the overridden 
ON KBD is restored when the calling context is restored. 

The priority can be specified, with the highest priority represented by 15. The 
highest user-defined priority (15) is less than the priority for ON ERROR, 

ON END, and ON TIMEOUT (whose priorities are not user-definable). ON 
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KBD can interrupt service routines of other event-initiated branches with 
user-definable priorities, if the ON KBD priority is higher than the priority of 
the service routine (the current system priority). CALL and GOSUB service 
routines get the priority specified in the ON ... statement which set up the 
branch that invoked them. The system priority is not changed when a GOTO 
branch is taken. 

Any specified line label or line number must be in the same context as the ON 
KBD statement. CALL and GOSUB will return to the next line that would 
have been executed if the KBD event had not been serviced, and the system 
priority is restored to that which existed before the ON KBD branch was 
taken. RECOVER forces the program to go directly to the specified line in the 
context containing that ON KBD statement. When RECOVER forces a change 
of context, the system priority is restored to that which existed in the original 
(defining) context at the time that context was exited. 

CALL and RECOVER remain active when the context changes to a 
subprogram, unless the change in context is caused by a keyboard-originated 
call. GOSUB and GOTO remain active when the context changes to a 
subprogram, but the branch cannot be taken until the calling context is 
restored. 

ON KBD is disabled by DISABLE, deactivated by OFF KBD, and temporarily 
deactivated when the program is executing LINPUT, INPUT, or ENTER 
KBD. 

You can use a relative pointing device, such as the HP 46060A mouse on an 
HP-HIL interface, if the KBD BIN is present. 
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ON KEY 


Supported On 
Option Required 
Keyboard Executable 
Programmable 


In an IF ... THEN ... 


UX WS DOS IN 

None 

No 

Yes 

Yes 


This statement defines and enables an event-initiated branch to be taken when 
a softkey is pressed. 
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Item 

Description 

Range 

key selector 

numeric expression, rounded to an 
integer 

0 through 23 

prompt 

string expression; Default = no label 

— 

priority 

numeric expression, rounded to an 
integer; Default=l 

1 through 15 

line label 

name of a program line 

any valid name 

line number 

integer constant identifying a 
program line 

1 through 32 766 

subprogram 

name 

name of a SUB or CSUB subprogram 

any valid name 


Example Statements 

OH KEY 0 GOTO 150 

ON KEY 5 LABEL "Print",3 GOSUB Report 

Semantics 

The most recently executed ON KEY (or OFF KEY) definition for a particular 
softkey overrides any previous key definition. If the overriding ON KEY 
definition occurs in a context different from the one in which the overridden 
ON KEY occurs, the overridden ON KEY is restored when the calling context 
is restored. 

Labels appear in the two bottom lines of the CRT. The label of any key is 
bound to the current ON KEY definition. Therefore, when a definition is 
changed or restored, the label changes accordingly. If no label is specified, that 
label field is blank. Refer to the HP BASIC 6.2 Programming Guide for a 
discussion of these labels. 

The priority can be specified, with the highest priority represented by 15. The 
highest user-defined priority (15) is less than the priority for ON ERROR, 

ON END, and ON TIMEOUT (whose priorities are not user-definable). On 
KEY can interrupt service routines of other event-initiated branches with 
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user-definable priorities, if the ON KEY priority is higher than the priority of 
the service routine (the current system priority). CALL and GOSUB service 
routines get the priority specified in the ON ... statement which set up the 
branch that invoked them. The system priority is not changed when a GOTO 
branch is taken. 

Any specified line label or line number must be in the same context as the ON 
KEY statement. CALL and GOSUB will return to the next line that would 
have been executed if the KEY event had not been serviced, and the system 
priority is restored to that which existed before the ON KEY branch was 
taken. RECOVER forces the program to go directly to the specified line in the 
context containing that ON KEY statement. When RECOVER forces a change 
of context, the system priority is restored to that which existed in the original 
(defining) context at the time that context was exited. 

CALL and RECOVER remain active when the context changes to a 
subprogram, unless the change in context is caused by a keyboard-originated 
call. GOSUB and GOTO remain active when the context changes to a 
subprogram, but the branch cannot be taken until the calling context is 
restored. 

ON KEY is disabled by DISABLE, deactivated by OFF KEY, and temporarily 
deactivated when the program is paused or executing LINPUT, INPUT, or 
ENTER KBD. 
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ON KNOB 


Supported On 
Option Required 
Keyboard Executable 
Programmable 


In an IF ... THEN ... 


UX WS DOS 

None 

No 

Yes 

Yes 


This statement defines and enables an event-initiated branch to be taken when 
the knob is turned. 


f ON KNOB JH 


seconds 


> priority 


-»(gosub)- 



RECOVER 


_J 

line 

L 


lobel 



line 

number 





Item 

Description 

Range 

seconds 

numeric expression, rounded to the 
nearest 0.01 second 

0.01 through 2.55 

priority 

numeric expression, rounded to an 
integer; Default=l 

1 through 15 

line label 

name of a program line 

any valid name 

line number 

integer constant identifying a 
program line 

1 through 32 766 

subprogram 

name 

name of a SUB or CSUB subprogram 

any valid name 
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ON KNOB 

Example Statements 

ON KNOB .1 GOSUB 250 

ON KNOB .333,Priority CALL Pulses 


Semantics 

Turning the knob (cursor wheel) generates pulses. After ON KNOB is 
activated (or re-activated), the first pulse received starts a sampling interval. 
The “seconds” parameter establishes the length of that sampling interval. At 
the end of the sampling interval, the ON KNOB branch is taken if the net 
number of pulses received during the interval is not zero and priority permits. 
The KNOBX and KNOBY functions can be used to determine the number 
of pulses received during the interval. If the ON KNOB branch is held off for 
any reason, the KNOBX and KNOBY functions accumulate the pulses (see 
KNOBX and KNOBY). 

The priority can be specified, with the highest priority represented by 15. The 
highest user-defined priority (15) is less than the priority for ON ERROR, 

ON END, and ON TIMEOUT (whose priorities are not user-definable). ON 
KNOB can interrupt service routines of other event-initiated branches with 
user-definable priorities, if the ON KNOB priority is higher than the priority of 
the service routine (the current system priority). CALL and GOSUB service 
routines get the priority specified in the ON ... statement which set up the 
branch that invoked them. The system priority is not changed when a GOTO 
branch is taken. 

Any specified line label or line number must be in the same context as the ON 
KNOB statement. CALL and GOSUB will return to the next line that would 
have been executed if the KNOB event had not been serviced, and the system 
priority is restored to that which existed before the ON KNOB branch was 
taken. RECOVER forces the program to go directly to the specified line in 
the context containing that ON KNOB statement. When RECOVER forces a 
change of context, the system priority is restored to that which existed in the 
original (defining) context at the time that context was exited. 

CALL and RECOVER remain active when the context changes to a 
subprogram, unless the change in context is caused by a keyboard-originated 
call. GOSUB and GOTO remain active when the context changes to a 
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subprogram, but the branch cannot be taken until the calling context is 
restored. 

The most recent ON KNOB (or OFF KNOB) definition overrides any previous 
ON KNOB definition. If the overriding ON KNOB definition occurs in a 
context different from the one in which the overridden ON KNOB occurs, the 
overridden ON KNOB is restored when the calling context is restored, but the 
“seconds” parameter of the more recent ON KNOB remains in effect. (See 
below for restrictions.) 

ON KNOB is disabled by DISABLE and deactivated by OFF KNOB. 

You can use an HP-HIL relative pointing device, such as a mouse or knob, if 
the KBD binary is loaded. 

The ON KNOB statement behaves like the ON CDIAL and ON HIL EXT 
statements: 

■ When ON KNOB is executed in a SUB context and program control exits 
that context, the pulses from control dials will continue to be accumulated 
(and can be read by KNOBX and KNOBY). No interrupts occur if there is 
no ON KNOB active in the current context. 

■ Conversely, if an ON KNOB has been executed in a context and then OFF 
KNOB is executed in a called context, then upon returning to the calling 
context the pulses will be routed to the BASIC system (instead of the 
KNOBX and KNOBY functions) and no interrupts will be initiated. 
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ON SIGNAL 


Supported On 
Option Required 
Keyboard Executable 
Programmable 


In an IF ... THEN ... 


UX WS DOS 
10 
No 
Yes 
Yes 


This statement defines and enables an event-initiated branch to be taken when 
a SIGNAL statement with the same signal selector is executed. 


(on signal)-*- 


signal 

selector 


priority 


prog 

L 

V- 

^ line 

label < k 

^ line >| 

number 

l , f j | A i subDroaram J 

^uALL J 9 name 


Item 

Description 

Range 

signal selector 

numeric expression, rounded to an 
integer 

0 through 15 

priority 

numeric expression, rounded to an 
integer; Default = 1 

1 through 15 

line label 

name of a program line 

any valid name 

line number 

integer constant identifying a 
program line 

1 through 32 766 

subprogram 

name 

name of a SUB or CSUB subprogram 

any valid name 
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Example Statements 

ON SIGNAL 5 GOSUB 550 

ON SIGNAL Bailout,15 RECOVER Bail.here 



Semantics 

The most recent ON SIGNAL (or OFF SIGNAL) definition for a given signal 
selector overrides any previous ON SIGNAL definition. If the overriding ON 
SIGNAL definition occurs in a context different from the one in which the 
overridden ON SIGNAL occurs, the overridden ON SIGNAL is restored when 
the calling context is restored. 

The priority can be specified, with the highest priority represented by 15. The 
highest user-defined priority (15) is less than the priority for ON ERROR, 

ON END, and ON TIMEOUT (whose priorities are not user-definable). ON 
SIGNAL can interrupt service routines of other event-initiated branches with 
user-definable priorities, if the ON SIGNAL priority is higher than the priority 
of the service routine (the current system priority). CALL and GOSUB service 
routines get the priority specified in the ON ... statement which set up the 
branch that invoked them. The system priority is not changed when a GOTO 
branch is taken. 

Any specified line label or line number must be in the same context as the ON 
SIGNAL statement. CALL and GOSUB will return to the next line that would 
have been executed if the SIGNAL event had not been serviced, and the system 
priority is restored to that which existed before the ON SIGNAL branch was 
taken. RECOVER forces the program to go directly to the specified line in the 
context containing that ON SIGNAL statement. When RECOVER forces a 
change of context, the system priority is restored to that which existed in the 
original (defining) context at the time that context was exited. 

CALL and RECOVER remain active when the context changes to a 
subprogram, unless the change in context is caused by a keyboard-originated 
call. GOSUB and GOTO remain active when the context changes to a 
subprogram, but the branch cannot be taken until the calling context is 
restored. 

ON SIGNAL is disabled by DISABLE and deactivated by OFF SIGNAL. 


OFF CDIAL - OUTPUT 0-63 


ON TIME 


o 


Supported on 
Option Required 
Keyboard Executable 
Programmable 


In an IF ... THEN ... 


UX WS DOS 

CLOCK 

No 

Yes 

Yes 


This statement defines and enables an event-initiated branch to be taken when 
the real-time clock reaches a specified time. 



Item 

Description 

Range 

seconds 

numeric expression, rounded to the 
nearest 0.01 second for BASIC/WS 
and 0.02 second for BASIC/UX 

0 through 86 399.99 

priority 

numeric expression, rounded to an 
integer; Default = 1 

1 through 15 

line label 

name of a program line 

any valid name 

line number 

integer constant identifying a 
program line 

1 through 32 766 

subprogram 

name 

name of a SUB or CSUB subprogram 

any valid name 
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Example Statements 

OK TIME 3600*8 GOTO Work 

ON TIME (TIMEDATE+3600) MOD 86400 CALL One.hour 

Semantics 

The most recent ON TIME (or OFF TIME) definition overrides any previous 
ON TIME definition. If the overriding ON TIME definition occurs in a 
context different from the one in which the overridden ON TIME occurs, 
the overridden ON TIME is restored when the calling context is restored, 
but the time value of the more recent ON TIME remains in effect. For more 
information on the behavior of ON TIME in different contexts, read the section 
“Branching Restrictions” in the chapter “Using the Clock and Timers” in the 
HP BASIC 6.2 Programming Guide. 

The priority can be specified, with the highest priority represented by 15. The 
highest user-defined priority (15) is less than the priority for ON ERROR, 

ON END, and ON TIMEOUT (whose priorities are not user-definable). ON 
TIME can interrupt service routines of other event-initiated branches with 
user-definable priorities, if the ON TIME priority is higher than the priority of 
the service routine (the current system priority). CALL and GOSUB service 
routines get the priority specified in the ON ... statement which set up the 
branch that invoked them. The system priority is not changed when a GOTO 
branch is taken. 

CALL and GOSUB will return to the next line that would have been executed 
if the TIME event had not been serviced, and the system priority is restored to 
that which existed before the ON TIME branch was taken. RECOVER forces 
the program to go directly to the specified line in the context containing that 
ON TIME statement. When RECOVER forces a change of context, the system 
priority is restored to that which existed in the original (defining) context at 
the time that context was exited. 

Any specified line label or line number must be in the same context as 
the ON TIME statement. CALL and RECOVER remain active when the 
context changes to a subprogram, unless the change in context is caused by a 
keyboard-originated call. GOSUB and GOTO remain active when the context 
changes to a subprogram, but the branch cannot be taken until the calling 
context is restored. 
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Unlike ON CYCLE, an ON TIME statement requires an exact match between 
the clock and the time specified in the defining statement. If the event was 
missed and not logged, re-executing the ON TIME statement will not result in 
a branch being taken. 

ON TIME is disabled by DISABLE and deactivated by OFF TIME. 

BASIC/UX Specifics 

Resolution is 20 milliseconds. A new child process of BASIC/UX is started for 
the timer. 
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ON TIMEOUT 


I 


Supported On 
Option Required 
Keyboard Executable 
Programmable 


In an IF ... THEN ... 


UX WS DOS* IN 

None 

No 

Yes 

Yes 


This statement defines and enables an event-initiated branch to be taken when 
an I/O timeout occurs on the specified interface. 



Item 

Description 

Range 

interface select 
code 

numeric expression, rounded to an 
integer 

7 through 31 

seconds 

numeric expression, rounded to the 
nearest 0.001 second for BASIC/WS 
and 0.020 second for BASIC/UX 

0.001 through 32.767 

line label 

name of a program line 

any valid name 

line number 

integer constant identifying a 
program line 

1 through 32 766 

subprogram 

name 

name of a SUB or CSUB subprogram 

any valid name 
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ON TIMEOUT 

Example Statements 

OH TIMEOUT 7,2.544 GOTO 770 
OH TIMEOUT Printer,Time GOSUB Message 


Semantics 

There is no default system timeout. If ON TIMEOUT is not in effect for an 
interface, a device can cause the program to wait forever. 

The specified branch occurs if an input or output is active on the interface 
and the interface has not responded within the number of seconds specified. 
The computer waits at least the specified time before generating an interrupt; 
however, it may wait up to an additional 25% of the specified time. 

Timeouts apply to ENTER and OUTPUT statements, and operations 
involving the PRINTER IS, PRINTALL IS, and PLOTTER IS devices when 
they are external. Timeouts do not apply to CONTROL, STATUS, READIO, 
WRITEIO, CRT alpha or graphics I/O, real time clock I/O, keyboard I/O, or 
mass storage operations. 

The priority associated with ON TIMEOUT is higher than priority 15. ON 
END and ON ERROR have the same priority as ON TIMEOUT, and can 
interrupt an ON TIMEOUT service routine. 

Any specified line label or line number must be in the same context as the ON 
TIMEOUT statement. CALL and GOSUB will return to the line immediately 
following the one during which the timeout occurred, and the system priority 
is restored to that which existed before the ON TIMEOUT branch was taken. 
RECOVER forces the program to go directly to the specified line in the 
context containing that ON TIMEOUT statement. When RECOVER forces a 
change of context, the system priority is restored to that which existed in the 
original (defining) context at the time that context was exited. 

CALL and RECOVER remain active when the context changes to a 
subprogram, unless the change in context is caused by a keyboard-originated 
call. GOSUB and GOTO do not remain active when the context changes to 
a subprogram. The TIMEOUT event does remain active. Unlike other ON 
events, TIMEOUTs are never logged, they always cause an immediate action. 
If a TIMEOUT occurs when the ON TIMEOUT branch cannot be taken, an 
error 168 is generated. This can be trapped with ON ERROR. The functions 
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ERRN and ERRDs are set only when the error is generated. They are not set 
when the ON TIMEOUT branch can be taken. 

ON TIMEOUT is deactivated by OFF TIMEOUT. DISABLE does not affect 
ON TIMEOUT. 

ON TIMEOUT with SRM Interfaces 

With SRM, ON TIMEOUT defines and enables a branch resulting from an I/O 
timeout on the specified SRM interface. Although ON TIMEOUT is supported 
on SRM, its use should be avoided because the asynchronous nature of the 
SRM system does not allow predictable results. 

A TIMEOUT occurring during statements such as RE-SAVE and RE-STORE 
may leave a temporary file on the mass storage device. The file’s name is a 
10-character identifier (the first character is an alpha character, the rest are 
digits) derived from the value of the workstation’s real-time clock when the 
TIMEOUT occurred. You may wish to check the contents of any such file 
before purging. 

BASIC/UX Specifics 

If the interface is an MUX, the interface select code must be a device selector 
with channel number included. For example, 

■ ON TIMEOUT 16 gives an error. 

■ ON TIMEOUT 1600 works. 

Note that you cannot set up an ON TIMEOUT for an HP-IB or GPIO 
interface when using burst I/O mode. 

Resolution is limited to 20 milliseconds. Accuracy depends on system load and 
real time priority, but is generally 40 milliseconds. 

BASIC/DOS Specifics 

Delay time for select codes 9, 15, 19, 23, 24, 25, and 26 for the measurement 
coprocessor is device dependent and is usually longer than for Series 200/300. 
Also, the delay may differ between the HP 82300 and HP 82324 coprocessors. 
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OPTION BASE 


Supported On 
Option Required 
Keyboard Executable 
Programmable 


In an IF ... THEN ... 


UX WS DOS 

None 

No 

Yes 

No 


This statement specifies the default lower bound of arrays. 


C 


OPTION BASE 



Example Statements 

OPTION BASE 0 
OPTION BASE 1 

Semantics 

This statement can occur only once in each context. If used, OPTION BASE 
must precede any explicit variable declarations in a context. Since arrays are 
passed to subprograms by reference, they maintain their original lower bound, 
even if the new context has a different OPTION BASE. Any context that does 
not contain an OPTION BASE statement assumes default lower bounds of 
zero. 

The OPTION BASE value is determined at prerun, and is used with all 
arrays declared without explicit lower bounds in COM, DIM, INTEGER, and 
REAL statements as well as with all implicitly dimensioned arrays. OPTION 
BASE is also used at runtime for any arrays declared without lower bounds in 
ALLOCATE. 
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OPTIONAL 

OPTIONAL 

See the DEF FN and SUB statements. 
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OR 


Supported On 
Option Required 
Keyboard Executable 
Programmable 
In an IF ... THEN .. 


UX WS DOS IN 

None 

Yes 

Yes 

Yes 


This operator returns a 1 or a 0 based on the logical inclusive-or of the 
arguments. 



numeric 

-+X OR }-*■ 

numeric 


expression 


expression 


Example Statements 

X=Y OR Z 

IF File_type OR Device THEN Process 


Semantics 

An expression which evaluates to a non-zero value is treated as a logical 1. An 
expression must evaluate to zero to be treated as a logical 0. 

The truth table is: 


A 

B 

A ORB 

0 

0 

0 

0 

1 

1 

1 

0 

1 

1 

1 

1 
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OUT 


OUT 


I 


See the SHIFT IN ... OUT option of ASSIGN, DUMP DEVICE IS, 
PRINTALL IS, and PRINTER IS statements. 
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OUTPUT 


Supported on 
Option Required 
Keyboard Executable 
Programmable 


In an IF ... THEN ... 


UX WS DOS IN 

None 

Yes 

Yes 

Yes 


This statement outputs items to the specified destination. 
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( OUTPUT ) -» destination 



OUTPUT 


Expended diagram. destination image items 
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OUTPUT 


Item 

Description 

Range 

I/O path name 

name assigned to a device, devices, 
mass storage file, buffer, or pipe 

any valid name 

record number 

numeric expression, rounded to an 
integer 

1 through 2 31 —1 

device selector 

numeric expression, rounded to an 
integer 

(see Glossary) 

destination 
string name 

name of a string variable 

any valid name 

subscript 

numeric expression, rounded to an 
integer 

-32 767 through +32 767 
(see “array” in Glossary) 

image line 
number 

integer constant identifying an 

IMAGE statement 

1 through 32 766 

image line label 

name identifying an IMAGE 
statement 

any valid name 

image specifier 

string expression 

(see drawing) 

string array 
name 

name of a string array 

any valid name 

numeric array 
name 

name of a numeric array 

any valid name 

image specifier 
list 

literal 

(see next drawing) 

repeat factor 

integer constant 

1 through 32 767 

literal 

string constant composed of 
characters from the keyboard, 
including those generated using the 
ANY CHAR key 

quote mark not allowed 
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OUTPUT 


Example Statements 

OUTPUT 701;Number,String$; 

OUTPUT CFile;Array(*).END 
OUTPUT QRand,5 USING Fmtl;Item(5) 
OUTPUT 12 USING "#,6A";B$[2;6] 
OUTPUT CPrinter;Rank;Id;Name$ 


Semantics 

Standard Numeric Format 

The standard numeric format depends on the value of the number being 
displayed. If the absolute value of the number is greater than or equal to IE-4 
and less than 1E+6, it is rounded to 12 digits and displayed in floating point 
notation. If it is not within these limits, it is displayed in scientific notation. 
The standard numeric format is used unless USING is selected, and may be 
specified by using K in an image specifier. 

COMPLEX numbers are treated like two REAL numbers. The separator 
following the item is also used as the separator between the real and imaginary 
parts. 

Arrays 

Entire arrays may be output by using the asterisk specifier. Each element in 
an array is treated as an item by the OUTPUT statement, as if the items were 
listed separately, separated by the punctuation following the array specifier. If 
no punctation follows the array specifier, a comma is assumed. The array is 
output in row major order (rightmost subscript varies fastest). COMPLEX 
arrays are treated as if they were REAL arrays with twice as many elements. 

Files as Destination 

If an I/O path has been assigned to a file, the file may be written to with 
OUTPUT statements. The file must be an ASCII, BDAT, DFS, or HP-UX 
file. The attributes specified in the ASSIGN statement are used if the file is a 
BDAT, DFS, or HP-UX file (ASCII files are always assigned a special case of 
the FORMAT ON attribute). 
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Serial access is available for ASCII, BDAT, DFS, and HP-UX files. Random 
access is available for BDAT, DFS, and HP-UX files. The end-of-file marker 
(EOF) and the file pointer are important to both serial and random access. 

The file pointer is set to the beginning of the file when the file is opened by an 
ASSIGN. It is updated by OUTPUT operations so that it always points to the 
next byte to be written. 

The EOF pointer is read from the media when the file is opened by an 
ASSIGN. On a newly created file, EOF is set to the beginning of the file. After 
each OUTPUT operation, the EOF pointer in the I/O path table is updated to 
the maximum of the file pointer or the previous EOF value. The EOF pointer 
on the volume is updated at the following times: 

■ When the current end-of-file changes. 

■ When END is specified in an OUTPUT statement directed to the file. 

■ When a CONTROL statement directed to the I/O path name changes the 
position of the EOF. 

Random access uses the record number parameter to write items to a specific 
location in a file. The OUTPUT begins at the start of the specified record 
and must fit into one record. The record specified cannot be beyond the 
record containing the EOF, if EOF is at the first byte of a record. The record 
specified can be one record beyond the record containing the EOF, if EOF is 
not at the first byte of a record. Random access is always allowed to records 
preceding the EOF record. If you wish to write randomly to a newly created 
file, either use a CONTROL statement to position the EOF in the last record, 
or write some “dummy” data into every record. 

When data is written to an ASCII file, each item is sent as an ASCII 
representation with a 2-byte length header. You cannot use OUTPUT with 
USING to ASCII files; see the following section, “OUTPUT with USING” for 
details. 

Data sent to a BDAT, DFS, or HP-UX file is sent in internal format if 
FORMAT OFF is currently assigned to the I/O path (this is the default 
FORMAT attribute for these file types), and is sent as ASCII characters if 
FORMAT ON has been explicitly assigned. (See “Devices as Destination” for a 
description of these formats.) 
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OUTPUT to DFS or HFS Files 

You must have W (write) permission on a DFS or HFS file, as well as X 
(search) permission on all superior directories, to output data to the file. If you 
do not have these permissions, error 183 is reported. 

DFS and HFS files are extensible. If the data output to the file with this 
statement would overflow the file’s space allocation, the file is extended. The 
BASIC system allocates the additional space needed to store the data being 
output, provided the disk contains enough unused storage space. 

OUTPUT to SRM Files 

You must have W (write) access capability on an SRM file, as well as R 
(read) capability on all superior directories, to output data to the file. If this 
capability is not public or if a password protecting this capability was not used 
at the time the file was assigned an I/O path name (with ASSIGN), error 62 is 
reported. 

SRM files are extensible. If the data output to the file with this statement 
would overflow the file’s space allocation, the file is extended. The BASIC 
system allocates an additional “extent size” amount of space, provided the disk 
contains enough unused storage space; see one of the CREATE statements for a 
description of “extent size”. 

Devices as Destination 

An I/O path or a device selector may be used to direct OUTPUT to a 
device. If a device selector is used, the default system attributes are used (see 
ASSIGN). If an I/O path is used, the ASSIGN statement used to associate 
the I/O path with the device also determines the attributes used. If multiple 
listeners were specified in the ASSIGN, the OUTPUT is directed to all of 
them. If FORMAT ON is the current attribute, the items are sent in ASCII. 
Items followed by a semicolon are sent with nothing following them. Numeric 
items followed by a comma are sent with a comma following them. String 
items followed by a comma are sent with a CR/LF following them. If the last 
item in the OUTPUT statement has no punctuation following it, the current 
end-of-line (EOL) sequence is sent after it. Trailing punctuation eliminates the 
automatic EOL. 
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If FORMAT OFF is the current attribute, items are sent to the device in 
internal format. Punctuation following items has no effect on the OUTPUT. 
Two bytes are sent for each INTEGER, eight bytes for each REAL, and 
sixteen bytes for each COMPLEX value. Each string output consists of a four 
byte header containing the length of the string, followed by the actual string 
characters. If the number of characters is odd, an additional byte containing a 
blank is sent after the last character. 

CRT as Destination 

If the device selector is 1, the OUTPUT is directed to the CRT. OUTPUT 
1 and PRINT differ in their treatment of separators and print fields. The 
OUTPUT format is described under “Devices as Destination.” See the PRINT 
keyword for a discussion of that format. OUTPUT 1 USING and PRINT 
USING to the CRT produce similar actions. 

Keyboard as Destination 

Outputs to device selector 2 may be used to simulate keystrokes. ASCII 
characters can be sent directly (i.e. “hello”). Non-ASCII keys (such as 
[execute 1 ) are simulated by a two-byte sequence. The first byte is CHR$(255), 
and the second byte can be found in the “Second Byte of Non-ASCII Key 
Sequences” table in the back of this book. 

When simulating keystrokes, unwanted characters (such as the EOL sequence) 
can be avoided with an image specifier (such as “#,B” or “#,K”). See 
“OUTPUT with USING.” 

Strings as Destination 

If a string is used for the destination, the string is treated similarly to a file. 
However, there is no file pointer; each OUTPUT begins at the beginning of the 
string, and writes serially within the string. 
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Buffers as Destination (Requires TRANS) 

When the destination is an I/O path name assigned to a buffer, data is placed 
in the buffer beginning at the location indicated by the buffer’s fill pointer. As 
data is sent, the current number-of-bytes 

register and fill pointer are adjusted accordingly. Encountering the empty 
pointer (buffer full) produces an error unless a continuous outbound 
TRANSFER is emptying the buffer. In this case, the OUTPUT will wait until 
there is more room in the buffer for data. 

If an I/O path is currently being used in an inbound TRANSFER, and an 
OUTPUT statement uses it as a destination, execution of the OUTPUT 
is deferred until the completion of the TRANSFER. An OUTPUT can be 
concurrent with an outbound TRANSFER only if the destination is the I/O 
path assigned to the buffer. 

An OUTPUT to a string variable that is also a buffer will not update the 
buffer’s pointers and will probably corrupt the data in the buffer. 

Pipes as Destination (BASIC/UX and BASIC/WS on SRM/UX) 

If an I/O path has been assigned to a pipe, the pipe may be written to with 
OUTPUT statements. The attributes specified in the ASSIGN statement are 
used. Data is sent in internal format if FORMAT OFF is currently assigned 
to the I/O path, and is sent as ASCII characters if FORMAT ON has been 
explicitly assigned (this is the default FORMAT attribute for pipes). (See 
“Devices as Destination” for a description of these formats.) 

Using END with Devices 

The secondary keyword END may be specified following the last item in an 
OUTPUT statement. The result, when USING is not specified, is to suppress 
the EOL (End-of-Line) sequence that would otherwise be output after the last 
byte of the last item. If a comma is used to separate the last item from the 
END keyword, the corresponding item terminator is output (CR/LF for string 
items or comma for numeric items). 

With HP-IB interfaces, END specifies an EOI signal to be sent with the last 
data byte of the last item. However, if no data is sent from the last output 
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item, EOI is not sent. With Data Communications interfaces, END specifies an 
end-of-data indication to be sent with the last byte of the last output item. 

OUTPUT With USING 

When the computer executes an OUTPUT USING statement, it reads the 
image specifier, acting on each field specifier (field specifiers are separated from 
each other by commas) as it is encountered. If nothing is required from the 
output items, the field specifier is acted upon without accessing the output list. 
When the field specifier requires characters, it accesses the next item in the 
output list, using the entire item. Each element in an array is considered a 
separate item. 

The processing of image specifiers stops when there is no matching display item 
(and the specifier requires a display item). If the image specifiers are exhausted 
before the display items, they are reused, starting at the beginning. 

COMPLEX values require two REAL image specifiers (i.e. each COMPLEX 
value is treated like two REAL values). 

If a numeric item requires more decimal places to the left of the decimal point 
than are provided by the field specifier, an error is generated. A minus sign 
takes a digit place if M or S is not used, and can generate unexpected overflows 
of the image field. If the number contains more digits to the right of the 
decimal point than specified, it is rounded to fit the specifier. 

If a string is longer than the field specifier, it is truncated, and the right-most 
characters are lost. If it is shorter than the specifier, trailing blanks are used to 
fill out the field. 

OUTPUT with USING cannot be used with output to ASCII files. 

Instead, direct the OUTPUT with USING to a string variable, and then 
OUTPUT this variable to the file. For instance, OUTPUT String$ USING 
M 5A,X,6D.D";Chars$,Number and then OUTPUT QFile;String$. 

Effects of the image specifiers on the OUTPUT statement are shown in the 
following table: 
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Image 

Specifier 

Meaning 

K 

Compact field. Outputs a number or string in standard form with no 
leading or trailing blanks. 

-K 

Same as K. 

H 

Similar to K, except the number is output using the European number 
format (comma radix). (Requires 10) 

-H 

Same as H. (Requires 10) 

S 

Outputs the number’s sign (+ or —). 

M 

Outputs the number’s sign if negative, a blank if positive. 

D 

Outputs one digit character. A leading zero is replaced by a blank. If 
the number is negative and no sign image is specified, the minus sign will 
occupy a leading digit position. If a sign is output, it will “float” to the 
left of the left-most digit. 

Z 

Same as D, except that leading zeros are output. 

* 

Like D, except that asterisks are output instead of leading zeros. (Requires 
IO) 

• 

Outputs a decimal-point radix indicator. 

R 

Outputs a comma radix indicator (European radix). (Requires 10) 

E 

Outputs an E, a sign, and a two-digit exponent. 

ESZ 

Outputs an E, a sign, and a one-digit exponent. 

ESZZ 

Same as E. 

ESZZZ 

Outputs an E, a sign, and a three-digit exponent. 

A 

Outputs a string character. Trailing blanks are output if the number 
of characters specified is greater than the number available in the 
corresponding string. If the image specifier is exhausted before the 
corresponding string, the remaining characters are ignored. Use AA or 2A 
for two-byte globalization characters. 

X 

Outputs a blank. 
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Image 

Specifier 

Meaning 

literal 

Outputs the characters contained in the literal. 

B 

Outputs the character represented by one byte of data. This is similar to 
the CHR$ function. The number is rounded to an INTEGER and the 
least-significant byte is sent. If the number is greater than 32 767, then 

255 is used; if the number is less than —32 768, then 0 is used. 

W 

Outputs a 16-bit word as a two’s-complement integer. The corresponding 
numeric item is rounded to an INTEGER. If it is greater than 32 767, then 
32 767 is sent; if it is less than —32 768, then —32 768 is sent. If either 
an I/O path name with the BYTE attribute or a device selector is used 
to access an 8-bit interface, two bytes will be output; the most-significant 
byte is sent first. If an I/O path name with the BYTE attribute is used to 
access a 16-bit interface, the BYTE attribute is overridden, and one word 
is output in a single operation. If an I/O path name with the WORD 
attribute is used to access a 16-bit interface, a null pad byte is output 
whenever necessary to achieve alignment on a word boundary. If the 
destination is a BDAT file, string variable, or buffer, the BYTE or WORD 
attribute is ignored and all data are sent as bytes; however, pad byte(s) 
will be output when necessary to achieve alignment on a word boundary. 
The pad character may be changed by using the CONVERT attribute; see 
the ASSIGN statement for further information. 

Y 

Like W, except that no pad bytes are output to achieve word alignment. If 
an I/O path with the BYTE attribute is used to access a 16-bit interface, 
the BYTE attribute is not overridden (as with the W specifier above). 
(Requires 10) 

# 

Suppresses the automatic output of the EOL (End-Of-Line) sequence 
following the last output item. 

% 

Ignored in OUTPUT images. 

+ 

Changes the automatic EOL sequence that normally follows the last 
output item to a single carriage-return. (Requires 10) 

— 

Changes the automatic EOL sequence that normally follows the last 
output item to a single line-feed. (Requires 10) 

/ 

Outputs a carriage-return and a line-feed. 
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Image 

Specifier 

Meaning 

L 

Outputs the current end-of-line (EOL) sequence. The default EOL 
characters are CR and LF; see ASSIGN for information on re-defining the 
EOL sequence. If the destination is an I/O path name with the WORD 
attribute, a pad byte may be sent after the EOL characters to achieve 
word alignment. 

@ 

Outputs a form-feed. 


Note Some localized versions of BASIC, such as Japanese localized 

BASIC, support two-byte characters. When using this localized 
language remember that the IMAGE, ENTER USING, 
OUTPUT USING, and PRINT USING statements define a 
one-byte ASCII character image with A. Use the image AA to 
designate a two-byte character. 

For a general discussion of globalization and localization, refer 
to the HP BASIC 6.2 Porting and Globalization manual. For 
LANGUAGE specific detalis, refer to Using LanguageX With 
HP BASIC, where LanguageX is your local language. 


END with OUTPUT ... USING 

Using the optional secondary keyword END in an OUTPUT ... USING 
statement produces results which differ from those in an OUTPUT statement 
without USING. Instead of always suppressing the EOL sequence, the END 
keyword only suppresses the EOL sequence when no data is output from 
the last output item. Thus, the # image specifier generally controls the 
suppression of the otherwise automatic EOL sequence. 

With HP-IB interfaces, END specifies an EOI signal to be sent with the 
last byte output. However, no EOI is sent if no data is sent from the last 
output item or the EOL sequence is suppressed. With Data Communications 
interfaces, END specifies an end-of-data indication to be sent at the same times 
an EOI would be sent on HP-IB interfaces. 
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BASIC/UX Specifics 

You can specify a window number or unnamed pipe as the output destination 
to OUTPUT. 
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See the ASSIGN statement. 
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PASS CONTROL 

Supported on 
Option Required 
Keyboard Executable 
Programmable 
In an IF ... THEN ... 


UX WS DOS IN 
10 
Yes 
Yes 
Yes 


This statement is used to pass the capability of Active Controller to a specified 
HP-IB device. 



Item 

Description 

j Range 

I/O path name 

name assigned to an HP-IB device 

any valid name 

device selector 

numeric expression, rounded to an 

must contain primary 


integer 

address (see Glossary) 


Example Statements 

PASS CONTROL 719 i 

PASS CONTROL CController_19 


Semantics 

Executing this statement first addresses the specified device to talk and then 
sends the Take Control message (TCT), after which Attention is placed in the 
False state. The computer then assumes the role of a bus device (a non-active 
controller). 
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The computer must currently be the active controller to execute this 
statement, and primary addressing (but not multiple listeners) must be 
specified. The controller may be either a System or Non-system controller. 


Summary of Bus Actions 



System Controller 

Not System Controller 


Interface Select 

Primary Address 

Interface Select 

Primary Address 


Code Only 

Specified 

Code Only 

Specified 

Active 

Error 


Error 


Controller 


fjj'‘ 


■ 













ATN 


ATN 

Not Active 
Controller 

Error 

Error 

Error 

Error 


BASIC/UX Specifics 

You cannot pass control on an interface containing a swap device or mounted 
file system. 


BASIC/DOS Specifics 

PASS CONTROL is fully supported for the measurement coprocessor’s built-in 
HP-IB. PASS CONTROL is not supported for PC plug-in HP-IB cards such as 
the HP 82335A (select code 24 or 25). 
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PAUSE 


Supported On 
Option Required 
Keyboard Executable 
Programmable 
In an IF ... THEN 


UX WS DOS IN 

None 

Yes 

Yes 

Yes 


This statement suspends program execution. (Also see TRACE PAUSE.) 



Semantics 

PAUSE suspends program execution before the next line is executed, until the 
[CONTINUE) key is pressed or CONT is executed. If the program is modified 
while paused, RUN must be used to restart program execution. 

When program execution resumes, the computer attempts to service any ON 
INTR events that occurred while the program was paused. ON END, ON 
ERROR, or ON TIMEOUT events generate errors if they occur while the 
program is paused. ON KEY and ON KNOB events are ignored while the 
program is paused. 

Pressing the f pause 1 (or [stop] on an ITF keyboard) key, or typing PAUSE and 
pressing [execute) , [enter! or ( Return ! will suspend program execution at the 
end of the line currently being executed. 
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Supported On 
Option Required 
Keyboard Executable 
Programmable 
In an IF ... THEN .. 


UX WS DOS 

GRAPH 

Yes 

Yes 

Yes 


This statement specifies the angle with which IPLOT, RPLOT, POLYGON, 
POLYLINE, and RECTANGLE output are rotated. 



Item 

Description 

Range 

angle 

numeric expression in current units of 
angle; Default = 0 

— 


Example Statements 

PDIR 20 
PDIR ACS(Side) 

Semantics 

The rotation is about the local origin of the RPLOT, POLYGON, POLYLINE 
or RECTANGLE. 

The angle is interpreted as counter-clockwise rotation from the X-axis. 
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PEN 


Supported On 
Option Required 
Keyboard Executable 
Programmable 
In an IF ... THEN 


UX WS DOS IN 

GRAPH 

Yes 

Yes 

Yes 


This statement selects a pen value to be used for all subsequent lines. (For 
information about PEN as a secondary keyword, see the AREA statement.) 



P 


Item 

Description 

Range 

pen selector 

numeric expression, rounded to an 

-32 768 through +32 767 


integer 

(device dependent) 


Example Statements 

PEN 4 

PEN Select 

PEN Pen_number(I,J) 


Semantics 

For devices which support more than one line color (color or gray scale CRT), 
or physical pen (external hard copy plotters), this statement specifies the line 
color or physical pen to be used for all subsequent lines until the execution of 
another PEN statement or until the execution of a PLOT, IPLOT, RPLOT, or 
SYMBOL statement with an array argument which changes the pen color (see 
Operation Selector 3 of these statements). The sign of the pen selectors affects 
the drawing mode. 
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In color map mode, specifying PEN 14 actually means “write a 14 into the 
frame buffer.” The value of the frame buffer specifies the entry in the color 
map to be used, which in turn describes the actual color to be used. 

The PEN statement can also be used to specify that the current drawing 
mode is to erase lines on all devices which support such an operation. This is 
specified with a negative pen number. An alternate mode of operation which 
allows non-dominant and complementing drawing may be accessed through 
the GESCAPE function. “Complement” means to change the state of pixels; 
that is, to draw lines where there are none, and to erase where lines already 
exist. When the PEN statement is executed, the pen used is mapped into the 
appropriate range, retaining the sign. For example, if you specify pen +8 on a 
device whose pens range from —7 through 7, it would actually use pen +1. The 
formulae used are as follows: 

For monochromatic displays: 

If pen selector > 0 then use PEN 1 (draw lines) 

If pen selector = 0 then use PEN 0 (complement lines) 

If pen selector < 0 then use PEN —1 (erase lines) 

For color displays not in COLOR MAP mode and the HP 98627A: 

If pen selector > 0 then use PEN (pen selector — 1) MOD 7 + 1 
If pen selector = 0 then use PEN 0 (complement) 

If pen selector < 0 then use PEN — ((ABS(pen selector) — 1) MOD 7+1) 

For color or gray scale displays in COLOR MAP mode: 

If pen selector>0 then use PEN (pen selector — 1) MOD MaxPen + 1 
If pen selector=0 then use PEN 0 

If pen selector<0 then use PEN — ((ABS(pen selector) — 1) MOD MaxPen 

+ 1 ) 

Where MaxPen is the highest pen number (the lowest is 0). Four planes: 
MaxPen=15; six planes: MaxPen=63; eight planes: MaxPen=255. 

For an HPGL Plotter: 

Use PEN pen selector 

On an HPGL plotter, no checking is done to determine if the requested pen 
actually exists. Pen 0 puts away any pen if the plotter supports such an 
operation. 
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Non-Color Map Mode p 

The value written into the frame buffer depends not only on what pen is being 
used, but whether or not the computer is in color map mode. The colors or 
gray levels for the default (non-color map) mode are given because the color 
map cannot be changed in this mode. 

The meanings of the different pen values are shown in the table below. The 
pen value can cause either a 1 (draw), a 0 (erase), no change, or invert the 
value of each location in the frame buffer. 


Non-Color Map Mode 


Pen 

Color 

Plane 1 
(Red) 

Plane 2 
(Green) 

Plane 3 
(Blue) 

1 

White 

1 

1 

1 

2 

Red 

1 

0 

0 

3 

Yellow 

1 

1 

0 

4 

Green 

0 

1 

0 

5 

Cyan 

0 

1 

1 

6 

Blue 

0 

0 

1 

7 

Magenta 

1 

0 

1 


For a gray scale monitor, pens 0 through 7 map to the following luminosities: 


Pen 

Luminosity 

0 

0 

1 

1 

2 

.30 

3 

.89 

4 

.59 

5 

.70 

6 

.11 

7 

.41 
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Since hue and saturation are not involved in gray scale mapping, the luminosity 
values of pens 0 through 7 are simply repeated 32 times for pens 8 through 
255. 

Drawing with the pen numbers indicated in the above table results in the 
frame buffer planes being set to the indicated values. Drawing with the 
negatives of the pen numbers while in normal pen mode causes the bits to be 
cleared where there are Is in the table. Drawing with the negatives of the pen 
numbers while in alternate pen mode causes the bits to be inverted where there 
are Is in the table. In either case, no change will take place where there are Os 
in the table. Although complementing lines can be drawn, complementing area 
fills cannot be executed. 

Positive pen numbers in alternate drawing mode allows non-dominant drawing. 
(Non-dominant drawing causes the values in the frame buffer to be inclusively 
ORed with the value of the pen.) Pen 0 in normal mode complements. Pen 0 
in alternate mode draws in the background color. Since the table represents the 
computer in non-color map mode, table entries for any additional frame buffer 
planes are all zeros. 

Color Map Mode 

When operating the color or gray scale display in color map mode, pen colors 
can be redefined at will. For this reason, no colors are mentioned in the 
following table. Unlike non-color-map mode, the fourth bit in the frame buffer 
is used when in color map mode. Also, memory planes 1, 2, and 3 are not 
associated with red, green, and blue. 

Drawing with a pen merely puts the pen number into that pixel’s location. The 
computer looks into the corresponding entry in the color map to determine 
what actual color the pixel is to exhibit. 
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Pen 

Action 

Plane 1 

Plane 2 

Plane 3 

Plane 4 

0 

Background 

0 

0 

0 

0 

1 

Draw Pen 1 

1 

0 

0 

0 

2 

Draw Pen 2 

0 

1 

0 

0 

3 

Draw Pen 3 

1 

1 

0 

0 

4 

Draw Pen 4 

o 

0 

1 

0 

5 

Draw Pen 5 

1 

0 

1 

0 

6 

Draw Pen 6 

0 

1 

1 

0 

7 

Draw Pen 7 

1 

1 

1 

0 

8 

Draw Pen 8 

0 

0 

0 

1 

9 

Draw Pen 9 

1 

0 

0 

1 

10 

Draw Pen 10 

0 

1 

0 

1 

11 

Draw Pen 11 

1 

1 

0 

1 

12 

Draw Pen 12 

0 

0 

4 1 

1 

13 

Draw Pen 13 

1 

0 

1 

1 

14 

Draw Pen 14 

0 

1 

1 

1 

15 

Draw Pen 15 

1 

1 

1 

1 


Drawing with the negatives of the pen numbers while in normal pen mode 
causes the bits to be cleared where there are Is in the table. Drawing with the 
negatives of the pen numbers while in alternate pen mode causes the bits to be 
inverted where there are Is in the table. In either case, no change will take 
place where there are Os in the table. 

Pen 0 merely draws in the background color. Although complementing lines 
can be drawn, complementing area fills cannot be executed. 


PARITY-PURGE P-11 



PEN 


p Default Colors 

The RGB and HSL values for the default pen colors while in color map mode 
are shown below. These can be changed by the SET PEN statement. First, the 
RGB (red/green/blue) values: 


Pen 

Color 

Red 

Green 

Blue 

0 

Black 

0 

0 

0 

1 

White 

1 

1 

1 

2 

Red 

1 

0 

0 

3 

Yellow 

1 

1 

0 

4 

Green 

0 

1 

0 

5 

Cyan 

0 

1 

1 

6 

Blue 

0 

0 

1 

7 

Magenta 

1 

0 

1 

8 

Black 

0 

0 

0 

9 

Olive Green 

.80 

.73 

.20 

10 

Aqua 

.20 

.67 

.47 

11 

Royal Blue 

.53 

.40 

.67 

12 

Maroon 

.80 

.27 

.40 

13 

Brick Red 

1.00 

.40 

.20 

14 

Orange 

1.00 

.47 

0.00 

15 

Brown 

.87 

.53 

.27 
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The same default color map colors are represented below in their HSL 
(hue/saturation/luminosity) representations: 


Pen 

Color 

Hue 

Sat. 

Lum. 

0 

Black 

0 

0 

0 

1 

White 

0 

0 

1 

2 

Red 

0 

1 

1 

3 

Yellow 

.17 

1 

1 

4 

Green 

.33 

1 

1 

5 

Cyan 

.50 

1 

1 

6 

Blue 

.67 

1 

1 

7 

Magenta 

.83 

1 

1 

8 

Black 

0 

0 

0 

9 

Olive Green 

.15 

.75 

.80 

10 

Aqua 

.44 

.75 

.68 

11 

Royal Blue 

.75 

.36 

.64 

12 

Maroon 

.95 

.65 

.78 

13 

Brick Red 

.04 

.80 

1.00 

14 

Orange 

.08 

1.00 

1.00 

15 

Brown 

.08 

.70 

.85 
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For a gray scale monitor, pens 0 through 15 map to the following luminosities 


Pen 

Luminosity 

0 

0 

1 

1 

2 

.30 

3 

.89 

4 

.59 

5 

.70 

6 

.11 

7 

.41 

8 

0 

9 

.69 

10 

.51 

11 

.47 

12 

.44 

13 

.56 

14 

.58 

15 

.60 


To calculate luminosity for pens 16 through 255, use the following formula: 

, . . 256 — pen 

luminosity = - 

y 241 
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PENUP 


Supported On 
Option Required 
Keyboard Executable 
Programmable 


In an IF... THEN... 


UX WS DOS 

GRAPH 

Yes 

Yes 

Yes 


This statement lifts the pen on the current plotting device. 
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PERMIT 


Supported on 
Option Required 
Keyboard Executable 
Programmable 


In an IF ... THEN ... 


UX WS DOS* 

None 

Yes 

Yes 

Yes 


This statement modifies the owner, group, or public access permissions of an 
HFS or SRM/UX file or directory. 



literal form of HFS or SRM/UX file or directory specifier: 
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Item 

Description 

Range 

file or directory 

string expression specifying a file on 

(see drawing) 

specifier 

an HFS or SRM/UX volume 


directory path 

literal 

(see MASS STORAGE IS) 

HFS file or 
directory name 

literal 

1 to 14 characters (see 
Glossary) 

SRM/UX file 
or directory 

name 

literal 

1 to 16 characters 

volume specifier 

literal 

(see MASS STORAGE IS) 


Example Statements 

PERMIT Dir_path$ft File$ft Volume$ 

PERMIT "/DirPath/HFSfile";OWNER:READ,WRITE; GROUP:READ 
PERMIT "/DirPath/Dir";OTHER:SEARCH 
PERMIT "File"; OWNER:READ,WRITE; OTHER:READ 
PERMIT "Dir"; GROUP:READ; OTHER: 

PERMIT "File" 

PERMIT "Directory" 

Semantics 

The PERMIT statement is used to: 

■ change the permissions (access rights) of a file or directory on an HFS disk or 
on SRM/UX, 

i permit or restrict access to files and directories by the file owner, a member 
of the file-owner’s group, or by all others. 

Restricting access is useful, for instance, to prevent accidental purges of files or 
to prevent others from reading or writing to a file. 

tfou must be the current owner of the file or directory in order to execute 
PERMIT. 

There are 9 bits of “permission” for HFS and SRM/UX files. 
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OWNER 

GROUP 

OTHER 

Read 

Write 

Search 

Read 

Write 

Search 

Read 

Write 

Search 


These bits are shown in the PERMISSION column (PERMS column for 
SRM/UX) of a CAT listing of the directory in which the file or directory 
resides (R for READ; W for WRITE; X for SEARCH; - for “no permission”): 


FILE NAME 

FILE 

TYPE 

NUM 

RECS 

REC 

LEN 

MODIFIED 

DATE TIME 

PERMISSION 

OWNER 

GROUP 

File 


8192 

1 

7-Nov-86 9:23 

RW-RW-RW- 

18 

9 

Directory 


256 

1 

7-Nov-86 9:24 

RVXRVXRVX 

18 

9 


The default permission bits for directories are: RWXRWXRWX. 

The default permission bits for files are: RW-RW-RW-. 

The default permissions on SRM/UX can be changed. See your system 

administrator if you want to change the default permissions. 

There are three classes of users: 

u OWNER—initially the person who created the file (ownership can be 
changed with the CHOWN statement). All BASIC/WS local files are created 
with an owner identifier of 18. BASIC/UX files and BASIC/WS files on 
SRM/UX default to the owner’s user id. See /etc/passwd (HP-UX) or 
/etc/srmdconf (SRM/UX) for listings of owner identifiers. 

■ GROUP—initially the “group” to which the file’s/directory’s “owner” 
belongs (but the group can be changed with the CHGRP statement). All 
BASIC/WS files are created with a group identifier of 9. BASIC/UX files 
and BASIC/WS files on SRM/UX default to the user’s group id. See 
/etc/group (HP-UX) or /etc/srmdconf (SRM/UX) for listings of group 
identifiers. 

■ OTHER—all other users who are not the owner and are not in the same 
group as the owner (known as “public” on the HP-UX system). 

Each class of users has three types of permissions for accessing a file or 

directory: 

■ Read—allows reading the file (such as with ASSIGN, ENTER, and GET). 
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■ Write—allows a user to modify the file’s contents (such as with OUTPUT or 
RE-STORE). 

■ Search—an operation on directories which allows you to include the directory 
in a directory path (such as with CAT and MASS STORAGE IS). 

When a user class is specified, all permission bits for that class are changed: 

■ If a permission is specified, then the corresponding permission bit is set; 

■ If a permission is omitted, the corresponding permission bit is cleared. 

If no user class is specified, the default permissions for that file are restored. 

For example, executing 

PERMIT "Div";Other: 
gives the following permission: 

rwxrwx— 
and executing: 

PERMIT "File" 

gives the following permission: 

RW-RW-RW- 

If you are using a version of BASIC that supports wildcards, you can use them 
in file specifiers with PERMIT. You must first enable wildcard recognition 
using WILDCARDS. Refer to the keyword entry for WILDCARDS for details. 

BASIC/DOS Specifics 

For the HFS file system, BASIC/DOS fully supports the PERMIT statement, 
but only if the HP 82313A Hierarchical File System has been installed. 

For the DFS file system, BASIC/DOS provides partial PERMIT functionality. 
By default, DFS sets the permission bits to “RW-RW-RW-” for all files 
(“RWXRWXRWX” for a directory). You can use the PERMIT statement to 
make a file read-only with the following statement. 

PERMIT “MYFILE” ;OWNER:READ 

This sets the permission bits to “R—R—R—”. You cannot set the GROUP 
a,nd OTHER bits separately. 
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You can make the file read-write (“RW-RW-RW-”) again with the statement: 
PERMIT “MYFILE” ;OWNER:WRITE 

You cannot change the permission bits of a DFS directory with PERMIT. 
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PI 


PI 


Supported On 
Option Required 
Keyboard Executable 
Programmable 


In an IF... THEN... 


UX WS DOS IN 

None 

Yes 

Yes 

Yes 


This function returns 3.141 592 653 589 79, which is an approximate value for 

7r. 


P 



Example Statements 

Area=PI*Radius“2 
PRINT X,X*2*PI 
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Supported On 
Option Required 
Keyboard Executable 
Programmable 


In an IF ... THEN ... 


UX WS DOS 

GRAPH 

Yes 

Yes 

Yes 




This statement specifies a rotation of coordinates which is applied to all 
subsequently drawn lines. 


anql* 


Item 

Description 

Range 

angle 

numeric expression in current units of 
angle 

(same as COS) 


Example Statements 

PIVOT 30 

IF Special THEM PIVOT Radians 


Semantics 

The specified angle is interpreted according to the current angle mode (RAD or 
DEG). 

The specified angular rotation is performed about the logical pen’s position at 
the time the PIVOT is executed. This rotation is applied only to lines drawn 
subsequent to the PIVOT; logical pen movement is not affected by PIVOT. 
Consequently, PIVOT generally causes the logical and physical pens to be left 
at different positions. Other operations which cause similar effects are attempts 
to draw outside clip limits and direct HPGL output to plotters. 
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PLOT 


Supported On 
Option Required 
Keyboard Executable 
Programmable 
In an IF... THEN... 


UX WS DOS 

GRAPH 

Yes 

Yes 

Yes 


This statement moves the pen from the current pen position to the specified X 
and Y coordinates. It can be used to move without drawing, or to draw a line, 
depending on the pen control value. 



Item 

Description 

Range 

x coordinate 

numeric expression, in current units 

— 

y coordinate 

numeric expression, in current units 

— 

pen control 

numeric expression, rounded to an 
integer; Default = 1 (down after 
move) 

-32 768 through +32 767 

array name 

name of two-dimensional, two-column 
or three-column numeric array. 
(Requires GRAPHX) 

any valid name 
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Example Statements 

PLOT X,Y,-1 
PLOT -5,12 

PLOT Shape(*),FILL,EDGE 

Semantics 

Non-Array Parameters 

The specified X and Y position information is interpreted according to the 
current unit-of-measure. Lines are drawn using the current pen color and line 
type. 

PLOT is affected by the PIVOT transformation. 

The line is clipped at the current clipping boundary. If none of the line is 
inside the current clip limits, the pen is not moved, but the logical pen position 
is updated. 

Applicable Graphics Transformations 



Scaling 

PIVOT 

CSIZE 

LDIR 

PDIR 

Lines (generated by moves and draws) 

X 

X 



[4] 

Polygons and rectangles 

X 

X 



X 

Characters (generated by LABEL) 



X 

X 


Axes (generated by AXES & GRID) 

X 





Location of Labels 

[1] 

[3] 


[2] 



J The starting point for labels drawn after lines or axes is affected by scaling. 
2 The starting point for labels drawn after other labels is affected by LDIR. 
3 The starting point for labels drawn after lines or axes is affected by PIVOT. 
4 RPLOT and IPLOT are affected by PDIR. 

The optional pen control parameter specifies the following plotting actions; the 
default value is +1 (down after move). 
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Pen Control Parameter 


p 


Pen Control 

Resultant Action 

—Even 

Pen up before move 

-Odd 

Pen down before move 

-fEven 

Pen up after move 

+Odd 

Pen down after move 


The above table is summed up by: even is up, odd is down, positive is after 
pen motion, negative is before pen motion. Zero is considered positive. 

Array Parameters 

When using the PLOT statement with an array, either a two-column or a 
three-column array may be used. If a two-column array is used, the third 
parameter is assumed to be +1; pen down after move. 

FILL and EDGE 

When FILL or EDGE is specified, each sequence of two or more lines forms a 
polygon. The polygon begins at the first point on the sequence, includes each 
successive point, and the final point is connected or closed back to the first 
point. A polygon is closed when the end of the array is reached, or when the 
value in the third column is an even number less than three, or in the range 5 
to 8 or 10 to 15. 

If FILL and/or EDGE are specified on the PLOT statement itself, it causes 
the polygons defined within it to be filled with the current fill color and/or 
edged with the current pen color. If polygon mode is entered from within 
the array, and the FILL/EDGE directive for that series of polygons differs 
from the FILL/EDGE directive on the PLOT statement itself, the directive 
in the array replaces the directive on the statement. In other words, if a 
“start polygon mode” operation selector (a 6, 10, or 11) is encountered, any 
current FILL/EDGE directive (whether specified by a keyword or an operation 
selector) is replaced by the new FILL/EDGE directive. 
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If FILL and EDGE are both declared on the PLOT statement, FILL occurs 
first. If neither one is specified, simple line drawing mode is assumed; that is, 
polygon closure does not take place. 

If you attempt to fill a figure on an HPGL plotter, the figure will not be filled, 
but will be edged, regardless of the directives on the statement. 

When using a PLOT statement with an array, the following table of operation 
selectors applies. An operation selector is the value in the third column of 
a row of the array to be plotted. The array must be a two-dimensional, 
two-column or three-column array. If the third column exists, it will contain 
operation selectors which instruct the computer to carry out certain operations. 
Polygons may be defined, edged (using the current pen), filled (using the 
current fill color), pen and line type may be selected, and so forth. 


Column 1 

Column 2 

Operation 

Selector 

Meaning 

X 

Y 

-2 

Pen up before moving 

X 

Y 

-1 

Pen down before moving 

X 

Y 

0 

Pen up after moving (Same as +2) 

X 

Y 

1 

Pen down after moving 

X 

Y 

2 

Pen up after moving 

pen number 

ignored 

3 

Select pen 

line type 

repeat value 

4 

Select line type 

color 

ignored 

5 

Color value 

ignored 

ignored 

6 

Start polygon mode with FILL 

ignored 

ignored 

7 

End polygon mode 

ignored 

ignored 

8 

End of data for array 

ignored 

ignored 

9 

NOP (no operation) 

ignored 

ignored 

10 

Start polygon mode with EDGE 

ignored 

ignored 

11 

Start polygon mode with FILL and 




EDGE 

ignored 

ignored 

12 

Draw a FRAME 

pen number 

ignored 

13 

Area pen value 

red value 

green value 

14 

Color 

blue value 

ignored 

15 

Value 

ignored 

ignored 

>15 

Ignored 


P-26 PARITY - PURGE 














PLOT 


Moving and Drawing 

If the operation selector is less than or equal to two, it is interpreted in exactly 
the same manner as the third parameter in a non-array PLOT statement. Even 
is up, odd is down, positive is after pen motion, negative is before pen motion. 
Zero is considered positive. 

Selecting Pens 

An operation selector of 3 selects a pen. The value in column one is the pen 
number desired. The value in column two is ignored. 

Selecting Line Types 

An operation selector of 4 selects a line type. The line type (column one) 
selects the pattern, and the repeat value (column two) is the length in GDUs 
that the line extends before a single occurrence of the pattern is finished and it 
starts over. On the CRT, the repeat value is evaluated and rounded down to 
the next multiple of 5, with 5 as the minimum. 

Selecting a Fill Color 

Operation selector 13 selects a pen from the color map with which to do 
area fills. This works identically to the AREA PEN statement. Column one 
contains the pen number. 

Defining a Fill Color 

Operation selector 14 is used in conjunction with operation selector 15. Red 
and green are specified in columns one and two, respectively, and column three 
has the value 14. Following this row in the array (not necessarily immediately), 
is a row whose operation selector in column three has the value of 15. The first 
column in that row contains the blue value. These numbers range from 0 to 
32 767, where 0 is no color and 32 767 is full intensity. Operation selectors 14 
and 15 together comprise the equivalent of an AREA INTENSITY statement, 
which means it can be used on a monochromatic, gray scale, or color display. 

Operation selector 15 actually puts the area intensity into effect, but only if an 
operation selector 14 has already been received. 
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Operation selector 5 is another way to select a fill color. The color selection is 
through a Red-Green-Blue (RGB) color model. The first column is encoded in 
the following manner. There are three groups of five bits right-justified in the 
word; that is, the most significant bit in the word is ignored. Each group of five 
bits contains a number which determines the intensity of the corresponding 
color component, which ranges from zero to sixteen. The value in each field 
will be sixteen minus the intensity of the color component. For example, if the 
value in the first column of the array is zero, all three five-bit values would 
thus be zero. Sixteen minus zero in all three cases would turn on all three color 
components to full intensity, and the resultant color would be a bright white. 

Assuming you have the desired intensities (which range from 0 thru 1) for red, 
green, and blue in the variables R, G, and B, respectively, the value for the first 
column in the array could be defined thus: 

ArrayCRow,1)=SHIFT(16*(1-B),-10)+SHIFT(16*(l-G),-5)+16*(l-R) 

If there is a pen color in the color map similar to that which you request here, 
that non-dithered color will be used. If there is not a similar color, you will get 
a dithered pattern. 

If you are using a gray scale display, Operation selector 5 uses the five bit 
values of the RGB color specified to calculate luminosity. The resulting gray 
luminosity is then used as the area fill. For detailed information on gray 
scale calculations, see the chapter “More About Color Graphics” in the 
HP BASIC 6.2 Advanced Programming Techniques manual. 

Polygons 

A six, ten, or eleven in the third column of the array begins a “polygon mode”. 
If the operation selector is 6, the polygon will be filled with the current fill 
color. If the operation selector is 10, the polygon will be edged with the current 
pen number and line type. If the operation selector is 11, the polygon will 
be both filled and edged. Many individual polygons can be filled without 
terminating the mode with an operation selector 7. This can be done by 
specifying several series of draws separated by moves. The first and second 
columns are ignored and should not contain the X and Y values of the first 
point of a polygon. 

Operation selector 7 in the third column of a plotted array terminates 
definition of a polygon to be edged and/or filled and also terminates the 
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polygon mode (entered by operation selectors 6, 10, or 11). The values in the 
first and second columns are ignored, and the X and Y values of the last data 
point should not be in them. Edging and/or filling of the most recent polygon 
will begin immediately upon encountering this operation selector. 

Doing a FRAME 

Operation selector 12 does a FRAME around the current soft-clip limits. 

Soft clip limits cannot be changed from within the PLOT statement, so one 
probably would not have more than one operation selector 12 in an array to 
PLOT, since the last FRAME will overwrite all the previous ones. 

Premature Termination 

Operation selector 8 causes the PLOT statement to be terminated. The PLOT 
statement will successfully terminate if the actual end of the array has been 
reached, so the use of operation selector 8 is optional. 

Ignoring Selected Rows in the Array 

Operation selector 9 causes the row of the array it is in to be ignored. Any 
operation selector greater that fifteen is also ignored, but operation selector 
9 is retained for compatibility reasons. Operation selectors less than —2 
are not ignored. If the value in the third column is less than zero, only 
evenness/oddness is considered. 
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Supported On 
Option Required 
Keyboard Executable 
Programmable 


In an IF... THEN... 


UX WS DOS 

GRAPH 

Yes 

Yes 

Yes 


This statement selects a plotting device, file, or pipe. 



literal form of display/plotter specifier: 
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Item 

Description 

Range 

device selector 

numeric expression, rounded to an 
integer 

(see Glossary) 

display/plot ter 
specifier 

string expression 

(see drawing) 

color map 
display specifier 

string expression 

INTERNAL or WINDOW 

file specifier 

string expression 

(see drawing) 

plot specifier 

string expression 

HPGL 

window 

specifier 

numeric expression 

WINDOW 

xmin 

numeric expression; Default = 
—392.75mm 

device dependent 

xmax 

numeric expression; Default = 
392.75mm 

device dependent 

ymin 

numeric expression; Default = 
-251.5mm 

device dependent 

ymax 

numeric expression; Default = 
251.5mm 

device dependent 

directory path 

literal 

(see MASS STORAGE IS) 

file name 

literal 

depends on volume’s format 
(see Glossary) 

LIF protect 
code 

literal; first two non-blank characters 
are significant 

> not allowed 

SRM password 

literal; first 16 non-blank characters 
are significant 

> not allowed 

volume specifier 

literal 

(see MASS STORAGE IS) 
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Example Statements 

PLOTTER IS 3,1$ 

PLOTTER IS CRT,"INTERNAL";COLOR MAP 
PLOTTER IS Dsg,"HPGL" 

PLOTTER IS "Newlile","HPGL" 

PLOTTER IS "/PL/PlotFile" 

PLOTTER IS "PlotFile:REMOTE","HPGL",6.2,256.2,6.9,186.9 

PLOTTER IS 601,"WINDOW";COLOR MAP BASIC/UX only 

PLOTTER IS "MyBDAT","HPGL";APPEND 
PLOTTER IS "File*" 

Semantics 

Plotters 

The hard clip limits of the plotter are read in when this statement is 
executed. Therefore, the specified device must be capable of responding to this 
interrogation. 

Files 

Using PLOTTER IS with a file specifier causes all subsequent plotter output 
to go to the indicated file. The file must be a BDAT or HP-UX file. The 
PLOTTER IS statement positions the file pointer to the beginning of the 
file unless you specify the APPEND option. Thus, PLOTTER IS overwrites 
existing files unless you specify APPEND. The file is closed when another 
PLOTTER IS statement is executed or SCRATCH A, GINIT or Reset is 
executed. 

An end-of-file error occurs when the end of a LIF file is reached. 

If you are using a version of BASIC that supports wildcards, you can use them 
in file specifiers with PLOTTER IS. You must first enable wildcard recognition 
using WILDCARDS. Refer to the keyword entry for WILDCARDS for details. 
Wildcard file specifiers used with PLOTTER IS must match one and only one 
file name. 

Xmin, Xmax, Ymin, Ymax are the hard clip limits of the plotter in millimeters. 
This assumes 0.025 mm per plotter unit. The default size is for an HP 7580 
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or HP 7585 D-size drawing. See the plotter manual for more information on 
plotter limits. If you want to send HPGL commands to a file that is currently 
the PLOTTER IS device, use the GSEND statement. (See the GSEND entry 
of this reference for details.) 

SRM and HFS Files 

In order to write to a PLOTTER IS file on an HFS volume, you need to have 
R (read) and W (write) permission on the file, and X (search) permission on all 
superior directories. 

In order to write to a PLOTTER IS file in an SRM volume, you need to have 
R (read) and W (write) permissions on the file, as well as R permission on all 
superior directories. 

No end-of-file errors occur on SRM or HFS files, because these files are 
extensible. That is, if the data output to the file with this statement would 
overflow the file’s space allocation, the file is automatically extended provided 
the disk contains enough unused storage space. 

SRM Plotter Spoolers 

If the specified file is in the SRM plotter spooler directory and the file contains 
data, then the SRM system sends the data to the plotting device (when the file 
is closed) and then purges the file. You may close the file by executing another 
PLOTTER IS statement, GINIT, SCRATCH A or SCRATCH BIN, or by 
pressing [reset! ( [SHIFT H pause! or [Shift H Break] ). 
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Displays 

The statement PLOTTER IS CRT, “INTERNAL" is executed whenever a graphics 
statement is executed which needs a plotter (see GINIT) and no plotter is 
active. The plotter activated is the first device encountered in the following 
order: 

1. The alpha display, if it has graphics capabilities 

2. Internal 98542A, 98543A, 98544A, 98545A, 98547A, 98548A, 98549A, 
98550A, 98700, or 98720 at select code 6 

3. Model 362/382 internal displays at select code 132. 

4. Non-bit-mapped alpha display with graphics capabilities at select code 3 
(BASIC/UX supports the 98546A compatibility interface only) 

5. External 98700 or 98720 at select code > 7 

6. 98627A at select code > 7 (BASIC/WS only). 

If the COLOR MAP option is specified and the plotting device has a color or 
gray map, the capability of changing the color or gray map is enabled (see SET 
PEN). Also, the values written into the frame buffer are different than they 
would be if color map mode was not enabled. 

If the COLOR MAP option is not included and the plotting device is the 
Model 236 color display, the 4th memory plane is cleared (BASIC/WS only). 

Non-Color Map Mode 

Executing a PLOTTER IS statement without the COLOR MAP keyword 
causes the color map to be defined as follows, where 0 is zero intensity and 1 
is full intensity. This emulates the HP 98627A non-color-mapped device on a 
color bit-mapped display. 
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Pen 

Color 

Red 

Green 

Blue 

0 

Complement 

0 

0 

0 

1 

White 

1 

1 

1 

2 

Red 

1 

0 

0 

3 

Yellow 

1 

1 

0 

4 

Green 

0 

1 

0 

5 

Cyan 

0 

1 

1 

6 

Blue 

0 

0 

1 

7 

Magenta 

1 

0 

1 


For a gray scale monitor, pens 0 through 7 map to the following luminosities: 


Pen 

Luminosity 

0 

0 

1 

1 

2 

.30 

3 

.89 

4 

.59 

5 

.70 

6 

.11 

7 

.41 


Since hue and saturation are not involved in gray scale mapping, the luminosity 
values of pens 0 through 7 are simply repeated 32 times for pens 8 through 
255. 

On a display with bit-mapped alpha, the non-color map mode affects the 
ALPHA PEN, PRINT PEN, KEY LABELS PEN, and KBD LINE PEN , 
statements as follows: 8 is black (the same as 0) and 9 through 15 are white 
(the same as 1). 

The complementing cursor will be white on top of all colors except white, in 
which case it will be black. 
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COLOR MAP 

In the COLOR MAP mode, the color map is initialized so that the first eight 
colors are the same as they were in the default mode, and the second eight 
colors simulate HP’s designer colors of plotter pen ink or gray map luminosity. 

Although the pen numbers select the same color or gray luminosity in color 
map mode as in non-color map mode (for the first eight pens), the actual 
values written to the frame buffer are different. This results from the different 
interpretation of the values in the frame buffer: in non-color map mode, the 
values are RGB values or gray luminosity; in color-map mode, the values 
are indices into the color or gray map. This means that a picture drawn in 
non-color map mode will change colors or gray luminosity if a PLOTTER IS 
with the COLOR MAP option is executed. The reverse is also true. 

On a console or a terminal, when the PLOTTER IS statement is executed, the 
color or gray map is initialized to a default state. If the graphics write-enable 
mask is left in the default mode, the entire color or gray map will be initialized 
as before. Otherwise, the following algorithm is used: all color or gray map 
entries whose binary representation has Is in non-graphics planes will remain 
unchanged. This is done to insure that only pens dedicated to graphics are 
initialized. For example, with a graphics write mask of 7 (binary 0000 0111), 
only pens 0 through 7 are initialized. Higher numbered pens would remain 
unchanged since their binary representation would have Is in non-graphics 
planes. 

In windows, the color map is initialized to whatever the color map was when 
BASIC was booted. 

Display Specifiers 

There are several values which can be used when specifying the display on 
which graphics operations are done: 

This is the safest of the possibilities. 
“CRT” is a built-in function which 
returns the value 1, and the value 1 
is interpreted by the graphics system 
as “the default display.” The default 
display may be an external display if 
no internal display exists. 
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PLOTTER IS 3,"INTERNAL" 


PLOTTER IS 6,"INTERNAL" 


PLOTTER IS devsel , "INTERNAL" 


PLOTTER IS windowJd , "WINDOW" 
(BASIC/UX only) 


PLOTTER IS devsel , "98627A" 
(BASIC/WS only) 


This specifies a non-bit-mapped 
display if there is one; otherwise, 
the action is equivalent to 
PLOTTER IS 1."INTERNAL". 
Specifying a value of 3 makes sense 
for all Series 200 displays except the 
Model 237. 

Always specifies a bit-mapped 
display. If one is not found, an error 
results. 

With the 98700 and 98720 displays, 
it is possible to configure the display 
card so that it is at an external 
select code. For example, if you set 
the select code to 25, you would use 
PLOTTER IS 25,"INTERNAL" 

This specifier works only in 
a windowing environment. A 
window id of 600 is equivalent to 
PLOTTER IS CRT,"INTERNAL" in the 
windowing environment. 

This specifies a color graphics 
display connected through the 
98627A interface card. This may 
have any one of several options 
specifying television format, 
etc. See the following table. 

PLOTTER IS devsel, "INTERNAL" is 
also accepted. 
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HP 98627A Display Specifiers 


Desired Display Format 

Display Specifier 

Standard Graphics 

512 by 390 pixels, 

60 Hz, non-interlaced 

"98627A M or "98627A;US STD" 

512 by 390 pixels, 

50 Hz, non-interlaced 

"98627A;EUR0 STD" 

High-Resolution Graphics 

512 by 512 pixels 

46.5 Hz, non-interlaced 

"98627A;HI RES" 

TV Compatible Graphics 

512 by 474 pixels, 

60 Hz, interlaced 
(30 Hz refresh rate) 

"98627A;US TV" 

512 by 512 pixels, 

50 Hz, interlaced 
(25 Hz refresh rate) 

"98627A;EUR0 TV" 
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Default Pen Colors 

The PLOTTER IS statement defines the color or gray map to default values 
in a non-windowing environment. These values are different depending on 
whether or not the COLOR MAP option was selected. The values, both in 
RGB and HSL, of the sixteen default pen colors are given below: 


Color Map Default Color Definitions (RGB) 


Pen 

Color 

Red 

Green 

Blue 

0 

Black 

0 

0 

0 

1 

White 

1 

1 

1 

2 

Red 

1 

0 

0 

3 

Yellow 

1 

1 

0 

4 

Green 

0 

1 

0 

5 

Cyan 

0 

1 

1 

6 

Blue 

0 

0 

1 

7 

Magenta 

1 

0 

1 

8 

Black 

0 

0 

0 

9 

Olive Green 

.80 

.73 

.20 

10 

Aqua 

.20 

.67 

.47 

11 

Royal Blue 

.53 

.40 

.67 

12 

Maroon 

.80 

.27 

.40 

13 

Brick Red 

1.00 

.40 

.20 

14 

Orange 

1.00 

.47 

0.00 

15 

Brown 

.87 

.53 

.27 
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The same default color map colors are represented below in their HSL 
(hue/saturation/luminosity) representations: 


Color Map Default Color Definitions (HSL) 


Pen 

Color 

Hue 

Sat. 

Lum. 

0 

Black 

0 

0 

0 

1 

White 

0 

0 

1 

2 

Red 

0 

1 

1 

3 

Yellow 

.17 

1 

1 

4 

Green 

.33 

1 

1 

5 

Cyan 

.50 

1 

1 

6 

Blue 

.67 

1 

1 

7 

Magenta 

.83 

1 

1 

8 

Black 

0 

0 

0 

9 

Olive Green 

.15 

.75 

.80 

10 

Aqua 

.44 

.75 

.68 

11 

Royal Blue 

.75 

.36 

.64 

12 

Maroon 

.95 

.65 

.78 

13 

Brick Red 

.04 

.80 

1.00 

14 

Orange 

.08 

1.00 

1.00 

15 

Brown 

.08 

.70 

.85 
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For a gray scale monitor, pens 0 through 15 map to the following luminosities: 


Pen 

Luminosity 

0 

0 

1 

1 

2 

.30 

3 

.89 

4 

.59 

5 

.70 

6 

.11 

7 

.41 

8 

0 

9 

.69 

10 

.51 

11 

.47 

12 

.44 

13 

.56 

14 

.58 

15 

.60 


To calculate luminosity for pens 16 through 255, use the following formula: 

, . . 256 — pen 

luminosity =- 

y 241 

Eight-plane machines have 256-entry color or gray maps. In these machines, 
pens 16 through 255 are defined to a variety of shades. For exact values, 
interrogate the color or gray map with GESCAPE. 

BASIC/UX Specifics 

BASIC/UX treats output to a pipe as it would output to a file. The pipe 
must be explicitly closed before any output becomes permanent (or takes 
place). Output to a spooled device will not be sent to the spooler until the 
pipe has been closed. The closing of pipes can be achieved with a subsequent 
PLOTTER IS, QUIT, or SCRATCH A command. 
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When running in the X Window environment, pen colors depend on the color 
map as determined by the parameters of the X Window System. 

■ In non-color map mode, graphics pen colors will appear as the first 8 colors 
of the X Window System color map. It is not true emulation of the HP 
98627A device, since executing PLOTTER IS with the COLOR MAP option 
will not change any of the colors of an existing picture. ALPHA PEN, 
PRINT PEN, KEY LABELS PEN, and KBD LINE PEN statements (and 
associated CRT control registers) will correspond to the X Window System 
color map in its entirety and not map values 9 through 15 to white as in 
BASIC/WS. 

■ In the COLOR MAP mode, graphics pen colors will map to the X Window 
System color map in its entirety. ALPHA PEN, PRINT PEN, KEY 
LABELS PEN, and KBD LINE PEN statements (and associated CRT 
control registers) will also correspond to the X Window System color map in 
its entirety. 
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POLYGON 


POLYGON 


Supported On 
Option Required 
Keyboard Executable 
Programmable 


In an IF... THEN... 


UX WS DOS 

GRAPHX 

Yes 

Yes 

Yes 


This statement draws all or part of a closed regular polygon. The polygon can 
be filled and/or edged. 


(polygon^ — tjrodius 




total 

sides 



Item 

Description 

Range 

radius 

numeric expression, in current units 

— 

total sides 

numeric expression, rounded to an 
integer. Default = 60 

3 through 32 767 

sides to draw 

numeric expression, rounded to an 
integer. Default = all sides 

1 through 32 767 


Example Statements 

POLYGON 1,5,5,4,FILL,EDGE 
POLYGON 4 
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Semantics 

The radius is the distance that the vertices of the polygon will be from the 
logical pen position. The first vertex will be at a distance specified by “radius” 
in the direction of the positive X-axis. Specifying a negative radius results in 
the figure being rotated 180°. POLYGON is affected by the PIVOT and the 
PDIR transformations. 

The total sides and the number of sides drawn need not be the same. Thus: 
POLYGON 1.5,8,5 

will start to drawn an octagon whose vertices are 1.5 units from the current 
pen position, but will only draw five sides of it before closing the polygon at 
the first point. If the number of sides to draw is greater than the specified total 
sides, sides to draw is treated as if it were equal to total sides. 

POLYGON forces polygon closure, that is, the first vertex is connected to the 
last vertex, so there is always an inside and an outside area. This is true even 
for the degenerate case of drawing only one side of a polygon, in which case a 
single line results. This is actually two lines, from the first point to the last 
point, and back to the first point. 

Polygon Shape 

The shape of the polygon is affected by the viewing transformation specified by 
SHOW or WINDOW. Therefore, anisotropic scaling causes the polygon to be 
distorted; stretched or compressed along the axes. If a rotation transformation 
is in effect, the polygon will be rotated first, then stretched or compressed 
along the unrotated axes. 

The pen status also affects the final shape of a polygon if sides to draw is less 
than total sides. If the pen is up at the time POLYGON is specified, the first 
vertex specified is connected to the last vertex specified, not including the 
center of the polygon, which is the current pen position. If the pen is down, 
however, the center of the polygon is also included in it. If sides to draw is less 
than total sides, piece-of-pie shaped polygon segments are created. 
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FILL and EDGE 

FILL causes the interior of the polygon or polygon segment to be filled with 
the current fill color as defined by AREA PEN, AREA COLOR, or AREA 
INTENSITY. EDGE causes the edges of the polygon to be drawn using the 
current pen and line type. If both FILL and EDGE are specified, the interior 
will be filled, then the edge will be drawn. If neither FILL nor EDGE is 
specified, EDGE is assumed. 

Polygons sent to an HPGL plotter are edged but not filled regardless of any 
FILL or EDGE directives in the statement. 

After POLYGON has executed, the pen is in the same position it was before 
the statement was executed, and the pen is up. The polygon is clipped at the 
current clip limits. 

Applicable Graphics Transformations 



Scaling 

PIVOT 

CSIZE 

LDIR 

PDIR 

Lines (generated by moves and 
draws) 

X 

X 



[4] 

Polygons and rectangles 

X 

X 



X 

Characters (generated by LABEL) 



X 

X 


Axes (generated by AXES & 

GRID) 

X 





Location of Labels 

[1] 

[3] 


[2] 



J The starting point for labels drawn after lines or axes is affected by scaling. 
2 The starting point for labels drawn after other labels is affected by LDIR. 
3 The starting point for labels drawn after lines or axes is affected by PIVOT. 
4 RPLOT and IPLOT are affected by PDIR. 
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BASIC/UX Specifics 

There are device dependent limitations on the number of vertices for which a 
correct FILL will be obtained. 

Polygon fills in the X Windows environment do not fill to include the lower and 
right boundaries. 
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POLYLINE 

Supported On 
Option Required 
Keyboard Executable 
Programmable 
In an IF ... THEN .. 


UX WS DOS 

GRAPHX 

Yes 

Yes 

Yes 


This statement draws all or part of an open regular polygon. 


(polyline ) ->j 


radius 


KIM 


total 

sides 


KM 


sides 
to draw 


Item 

Description 

Range 

radius 

numeric expression, in current units 

— 

total sides 

numeric expression, rounded to an 
integer. Default = 60 

3 through 32 767 

sides to draw 

numeric expression, rounded to an 
integer. Default = all sides 

1 through 32 767 


Example Statements 

POLYLINE Radius,Sides,Sides_to_draw 
POLYLINE 12,5 

Semantics 

The radius is the distance that the vertices of the polygon will be from the 
current pen position. The first vertex will be at a distance specified by 
“radius” in the direction of the positive X-axis. Specifying a negative radius 
results in the figure being rotated 180°. POLYLINE is affected by the PIVOT 
and the PDIR transformations. 
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The total sides and the number of sides drawn need not be the same. Thus: 
POLYLINE 1.5,8,5 

will start to drawn an octagon whose vertices are 1.5 units from the current 
pen position, but will only draw five sides of it. If the number of sides to draw 
is greater than the total sides specified, it is treated as if it were equal to the 
total sides. 

Shape of Perimeter 

POLYLINE does not force polygon closure, that is, if sides to draw is less than 
total sides, the first vertex is not connected to the last vertex, so there is no 
“inside” or “outside” area. 

The shape of the polygon is affected by the viewing transformation specified by 
SHOW or WINDOW. Therefore, anisotropic scaling causes the perimeter to be 
distorted; stretched or compressed along the axes. If a rotation transformation 
is in effect, the polygon will be rotated first, then stretched or compressed 
along the unrotated axes. 

The pen status also affects the way a POLYLINE statement works. If the pen 
is up at the time POLYLINE is specified, the first vertex is on the perimeter. If 
the pen is down, the first point is the current pen position, which is connected 
to the first point on the perimeter. 

After POLYLINE has executed, the current pen position is in the same 
position it was before the statement was executed, and the pen is up. The 
polygon is clipped at the current clip limits. 

Applicable Graphics Transformations 
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Scaling 

PIVOT 

CSIZE 

LDIR 

PDIR 

Lines (generated by moves and 
draws) 

X 

X 



[4] 

Polygons and rectangles 

X 

X 



X 

Characters (generated by 

LABEL) 



X 

X 


Axes (generated by AXES h 
GRID) 

X 





Location of Labels 

[1) 

[3] 


[2] 



lr The starting 
2 The starting 
3 The starting 
4 RPLOT and 


point for labels drawn after lines or axes is affected by scaling, 
point for labels drawn after other labels is affected by LDIR. 
point for labels drawn after lines or axes is affected by PIVOT. 
IPLOT are affected by PDIR. 
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p 


POS 


Supported On 
Option Required 
Keyboard Executable 
Programmable 


In an IF ... THEN ... 


UX WS DOS IN 

None 

Yes 

Yes 

Yes 


This function returns the byte position of the first occurrence of a substring 
within a string. If you are using ASCII characters, byte position equals 
character position. 




string 


searched 

for] 


KEh 


Item 

Description 

Range 

string searched 

string expression 

— 

string searched 

string expression 

— 

for 




Example Statements 

Point=POS(Big$,Little$) 

IF POS(A$,CHR$(10)) THEN Line.end 

Semantics 

If the value returned is greater than 0, it is the position of the first character of 
the string being searched for in the string being searched. If the value returned 
is 0, the string being searched for cannot be found (or the string searched for is 
the null string). 
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Note that the position returned is the relative position within the string 
expression used as the first argument. Thus, when a substring is searched, the 
position value refers to that substring. 

Two-byte Language Specifics 

Certain localized versions of BASIC, such as Japanese localized BASIC, 
support two-byte characters. The POS function can handle any combination 
of one- and two-byte characters. The value returned is the byte position of 
the first character being searched for. For more information about two-byte 
characters, refer to the globalization chapters of HP BASIC 6.2 Porting and 
Globalization. 
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Supported On 
Option Required 
Keyboard Executable 
Programmable 


In an IF ... THEN ... 


UX WS DOS 
10 
Yes 
Yes 
Yes 


This function returns a value representing eight status-bit messages of devices 
on the HP-IB. 


( pp0|j - X TVWS] hrKTH 




interface 
select code 


Item 

Description 

Range 

I/O path name 

name assigned to an interface select 

any valid name (see 


code 

ASSIGN) 

interface select 

numeric expression, rounded to an 

7 through 31 

code 

integer 



Example Statements 

Stat=PP0LL(7) 

IF BIT(PP0LL(«Hpib),3) THEN Respond 

Semantics 

The computer must be the active controller to execute this function. 
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Summary of Bus Actions 


Interface Select Code Only 

Primary Address Specified 

ATN & EOI 

(duration>25//s) 

Read byte 

EOI 

Restore ATN to 
previous state 

Error 
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Supported On 
Option Required 
Keyboard Executable 
Programmable 


In an IF ... THEN ... 


UX WS DOS 
10 
Yes 
Yes 
Yes 


This statement programs the logical sense and data bus line on which a 
specified device responds to a parallel poll. 



Item 

Description 

Range 

I/O path name 

name assigned to a device or devices 

any valid name 

device selector 

numeric expression, rounded to an 

must contain a primary 


integer 

address (see Glossary) 

configure byte 

numeric expression, rounded to an 
integer 

0 through 15 


Example Statements 

PPOLL CONFIGURE 711;2 
PPOLL CONFIGURE «Dvm;Response 
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Semantics 

This statement assumes that the device’s response is bus-programmable. The 
computer must be the active controller to execute this statement. 

The configure byte is coded. The three least significant bits determine the data 
bus line for the response. The fourth bit determines the logical sense of the 
response. 


Summary of Bus Actions 


Interface Select Code Only 

Primary Address Specified 


ATN 


MTA 


UNL 

Error 

LAG 


PPC 


PPE 
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p PPOLL RESPONSE 


Supported On 
Option Required 
Keyboard Executable 
Programmable 


In an IF ... THEN ... 


UX WS DOS 
10 
Yes 
Yes 
Yes 


This statement defines a response to be sent when an Active Controller 
performs a Parallel Poll on an HP-IB Interface. The response indicates whether 
this computer does or does not need service. 



Item 

Description 

Range 

I/O path name 

name assigned to an interface select 
code 

any valid name 

interface select 
code 

numeric expression, rounded to an 
integer 

7 through 31 

I do/don’t need 
service 

numeric expression, rounded to an 
integer 

0 or 1 


Examples 

PPOLL RESPONSE CHp_ib;I_need_service 
PPOLL RESPONSE Interface;0 
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Semantics 

This statement defines the computer’s response to a Parallel Poll (ATN & 

EOI) performed by the current Active Controller on the specified HP-IB 
Interface. This statement only sets up a potential response; no actual response 
is generated when the statement is executed. 

If the value of the “I do/don’t need service” parameter is 0, the computer is 
directed to place a logical false on the bit on which it has been defined to 
respond; this response will tell the Active Controller that this (non-active) 
controller does not need service. Any non-zero, positive value of this parameter 
(within the stated range) directs the computer to set up a true response, which 
will tell a polling Active Controller that the computer requires service. 

The bit on which the computer is to place its Parallel Poll response is 
determined by the value of the last “configure byte” written to CONTROL 
Register 5 of the corresponding HP-IB Interface. In general, this configure 
byte can be read from HP-IB STATUS Register 7 by the service routine 
that responds to Parallel-Poll-Configuration-Change interrupts (Bit 14 of 
the Interrupt Enable Register). This configure byte may then be written 
into HP-IB CONTROL Register 5, and the response desired by the Active 
Controller will be sent when a Parallel Poll is conducted. 

This statement may be executed by either an Active Controller or a non-active 
controller. 
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PPOLL UNCONFIGURE 


Supported On 
Option Required 
Keyboard Executable 
Programmable 
In an IF... THEN... 


UX WS DOS 
10 
Yes 
Yes 
Yes 



This statement disables the parallel poll response of a specified device or 
devices. * 


C 


PPOLL UNCONFIGURE 




I/O path 
name 


hrH 


interface 
select code 


Item 

Description 

Range 

I/O path name 

name assigned to a device or devices 

any valid name 

device selector 

numeric expression, rounded to an 
integer 

(see Glossary) 


Example Statements 

PPOLL UNCONFIGURE 7 
PPOLL UNCONFIGURE CPlotter 

Semantics 

The computer must be the active controller to execute PPOLL 
UNCONFIGURE. The computer may be either a System or Non-System 
Controller. 

If multiple devices are specified by an I/O path name, all specified devices 
are deactivated from parallel poll response. If the device selector or I/O path 
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name refers only to an interface select code, all devices on that interface are 
deactivated from parallel poll response. 


Summary of Bus Actions 


Interface Select Code Only 

Primary Address Specified 

ATN 

ATN 

PPU 

MTA 


UNL 


LAG 


PPC 


PPD 


PARITY - PURGE P-59 




PRINT 


Supported On 

UX WS DOS IN 

Option Required 

None 

Keyboard Executable 

Yes 

Programmable 

Yes 

In an IF ... THEN ... 

Yes 

This statement sends items 

to the PRINTER IS device. 
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PRINT 


literal form of image specifier 



Item 

Description 

Range 

image line 
number 

integer constant identifying an 

IMAGE statement 

1 through 32 766 

image line label 

name identifying an IMAGE 
statement 

any valid name 

image specifier 

string expression 

(see drawing) 

string array 
name 

name of a string array 

any valid name 

numeric array 

name 

name of a numeric array 

any valid name 

column 

numeric expression, rounded to an 
integer 

device dependent 

CRT column 

numeric expression, rounded to an 
integer 

1 through screen width 

CRT row 

numeric expression, rounded to an 
integer 

1 through alpha height 

image specifier 
list 

literal 

(see next drawing) 

repeat factor 

integer constant 

1 through 32 767 

literal 

string constant composed of 
characters from the keyboard, 
including those generated using the 
ANY CHAR key 

quote mark not allowed 
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Example Statements p 

PRINT "LINE";Number 
PRINT Array(*); 

PRINT TABXY(l.l),Header$,TABXY(Co1,3),MessageS 

PRINT USING "5Z.DD";Money 

PRINT USING Fmt3;Id,Item$,Kilograms/2.2 


Semantics 

Standard Numeric Format 

The standard numeric format depends on the value of the number being 
displayed. If the absolute value of the number is greater than or equal to IE-4 
and less than 1E+6, it is rounded to 12 digits and displayed in floating point 
notation. If it is not within these limits, it is displayed in scientific notation. 
The standard numeric format is used unless USING is selected, and may be 
specified by using K in an image specifier. 

COMPLEX numbers are treated like two REAL numbers separated by a 
semicolon. 

Automatic End-Of-Line Sequence 

After the print list is exhausted, an End-Of-Line (EOL) sequence is sent 
to the PRINTER IS device, unless it is suppressed by trailing punctuation 
or a pound-sign (#) image specifier. The printer width for EOL sequences 
generation is set to the screen width (50, 80 or 128 characters) for CRTs and 
to 80 for external devices unless the WIDTH attribute of the PRINTER IS 
statement was specified. WIDTH is off for files. This “printer width exceeded” 
EOL is not suppressed by trailing punctuation, but can be suppressed by the 
use of an image specifier. 
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Control Codes 

Some ASCII control codes have a special effect in PRINT statements if the 
PRINTER IS device is the CRT (device selector=l): 


Character 

Keystroke 

Name 

Action 

CHR$(7) 

tCTRLRGj 

bell 

Sounds the beeper 

CHR$(8) 

(ctrlKH) 

backspace 

Moves the print position back 
one character. 

CHRS(IO) 

fCTRLVm 

line-feed 

Moves the print position down 
one line. 

CHR$(12) 

fCTRLffn 

form-feed 

Prints two line-feeds, then 
advances the CRT buffer enough 
lines to place the next item at 
the top of the CRT. 

CHR$(13) 

(CTRL Km} 

carriage- 

return 

Moves the print position to 
column 1. 


The effect of ASCII control codes on a printer is device dependent. See your 
printer manual to find which control codes are recognized by your printer and 
their effects. 

CRT Enhancements 

There are several character enhancements (such as inverse video and 
underlining) available on some CRTs. They are accessed through characters 
with decimal values above 127. For a list of the characters and their effects, see 
the “Display Enhancement Characters” table in “Useful Tables” at the back of 
this book. 
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Arrays p 

Entire arrays may be printed using the asterisk specifier. Each element in 
an array is treated as a separate item by the PRINT statement, as if the 
items were listed separately, separated by the punctuation following the array 
specifier. If no punctation follows the array specifier, a comma is assumed. 
COMPLEX array elements are treated as if the real and imaginary parts are 
separated by a semicolon. The array is output in row major order (rightmost 
subscript varies fastest). 

PRINT Fields 

If PRINT is used without USING, the punctuation following an item 
determines the width of the item’s print field; a semicolon selects the compact 
field, and a comma selects the default print field. Any trailing punctation will 
suppress the automatic EOL sequence, in addition to selecting the print field to 
be used for the print item preceding it. 

The compact field is slightly different for numeric and string items. Numeric 
items are printed with one trailing blank. String items are printed with no 
leading or trailing blanks. 

The default print field prints items with trailing blanks to fill to the beginning 
of the next 10-character field. 

Numeric data is printed with one leading blank if the number is positive, or 
with a minus sign if the number is negative, whether in compact or default 
field. 

TAB 

The TAB function is used to position the next character to be printed on a 
line. In the TAB function, a column parameter less than one is treated as one. 

A column parameter greater than zero is subjected to the following formula: 

TAB position = ((column — 1) MOD width) + 1; where “width” is 50 for the 
Model 226 CRT, 128 for Model 237 and other hi-resolution displays, and 80 
for all other devices. If the TAB position evaluates to a column number less 
than or equal to the number of characters printed since the last EOL sequence, 
then an EOL sequence is printed, followed by (TAB position — 1) blanks. If 
the TAB position evaluates to a column number greater than the number of 
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characters printed since the last EOL, sufficient blanks are printed to move to 
the TAB position. 

TABXY 

The TABXY function provides X-Y character positioning on the CRT. 

It is ignored if a device other than the CRT is the PRINTER IS device. 
TABXY(1,1) specifies the upper left-hand corner of the CRT. If a negative 
value is provided for CRT row or CRT column, it is an error. Any number 
greater than the screen width for CRT column is treated as the last column on 
the screen. Any number greater than the height of the output area for CRT 
row is treated as the last line of the output area. If 0 is provided for either 
parameter, the current value of that parameter remains unchanged. 


Display Type 

Output Area Height 

Display Width 

226 

18 

50 

216, 220, 236, and 

98546, DOS EGA 

18 

80 

98542 and 98543 

19 

80 

DOS VGA 

27 

80 

237, 98544, 98545, 

98547, 98549, 98700, 
and Model 362/382 

1024 x 768 internal 

41 

128 

98548 and 98550 

44 

128 

Model 362/382 640 X 

480 internal, DOS VGA 

23 

80 
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PRINT With Using 

When the computer executes a PRINT USING statement, it reads the image 
specifier, acting on each field specifier (field specifiers are separated from each 
other by commas) as it is encountered. If nothing is required from the print 
items, the field specifier is acted upon without accessing the print list. When 
the field specifier requires characters, it accesses the next item in the print list, 
using the entire item. Each element in an array is considered a separate item. 

The processing of image specifiers stops when there is no matching display item 
(and the specifier requires a display item). If the image specifiers are exhausted 
before the display items, they are reused, starting at the beginning. 

COMPLEX values require two REAL image specifiers (i.e. each COMPLEX 
value is treated like two REAL values). 

If a numeric item requires more decimal places to the left of the decimal point 
than are provided by the field specifier, an error is generated. A minus sign 
takes a digit place if M or S is not used, and can generate unexpected overflows 
of the image field. If the number contains more digits to the right of the 
decimal point than are specified, it is rounded to fit the specifier. 

If a string is longer than the field specifier, it is truncated, and the right-most 
characters are lost. If it is shorter than the specifier, trailing blanks are used to 
fill out the field. 

Effects of the image specifiers on the PRINT statement are shown in the 
following table: 
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Image 

Specifier 

Meaning 

K 

Compact field. Prints a number or string in standard form with no leading 
or trailing blanks. 

-K 

Same as K. 

H 

Similar to K, except the number is printed using the European number 
format (comma radix). (Requires 10) 

-H 

Same as H. (Requires 10) 

S 

Prints the number’s sign (-f or —). 

M 

Prints the number’s sign if negative, a blank if positive. 

D 

Prints one digit character. A leading zero is replaced by a blank. If the 
number is negative and no sign image is specified, the minus sign will 
occupy a leading digit position. If a sign is printed, it will “float” to the 
left of the left-most digit. 

Z 

Same as D, except that leading zeros are printed. 

* 

Like Z, except that asterisks are printed instead of leading zeros. (Requires 
10) 


Prints a decimal-point radix indicator. 

R 

Prints a comma radix indicator (European radix). (Requires IO) 

E 

Prints an E, a sign, and a two-digit exponent. 

ESZ 

Prints an E, a sign, and a one-digit exponent. 

ESZZ 

Same as E. 

ESZZZ 

Prints an E, a sign, and a three-digit exponent. 

A 

Prints a string character. Trailing blanks are output if the number 
of characters specified is greater than the number available in the 
corresponding string. If the image specifier is exhausted before the 
corresponding string, the remaining characters are ignored. Use AA or 2A 
for two-byte globalization characters. 
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Image 

Specifier Meaning 

X Prints a blank. 

literal Prints the characters contained in the literal. 

B Prints the character represented by one byte of data. This is similar to 
the CHR$ function. The number is rounded to an INTEGER and the 
least-significant byte is sent. If the number is greater than 32 767, then 
255 is used; if the number is less than —32 768, then 0 is used. 

W Prints two characters represented by the two bytes in a 16-bit, 

two’s-complement integer word. The corresponding numeric item is 
rounded to an INTEGER. If it is greater than 32 767, then 32 767 is used; 
if it is less than —32 768, then —32 768 is used. On an 8-bit interface, the 
most-significant byte is sent first. On a 16-bit interface, the two bytes are 
sent as one word in a single operation. 

Y Same as W. (Requires 10) 

# Suppresses the automatic output of the EOL (End-Of-Line) sequence 
following the last print item. 

% Ignored in PRINT images. 

+ Changes the automatic EOL sequence that normally follows the last print 
item to a single carriage-return. (Requires 10) 

— Changes the automatic EOL sequence that normally follows the last print 
item to a single line-feed. (Requires 10) 

/ Sends a carriage-return and a line-feed to the PRINTER IS device. 

L Sends the current EOL sequence to the PRINTER IS device. The default 

EOL characters are CR and LF; see PRINTER IS for information on 
re-defining the EOL sequence. If the destination is an I/O path name with 
the WORD attribute, a pad byte may be sent after the EOL characters to 
achieve word alignment. 

@ Sends a form-feed to the PRINTER IS device. 
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Note 


Some localized versions of BASIC, such as Japanese localized 
BASIC, support two-byte characters. When using this localized 
language remember that the IMAGE, ENTER USING, 
OUTPUT USING, and PRINT USING statements define a 
one-byte ASCII character image with A. Use the image AA to 
designate a two-byte character. 

For a general discussion of globalization and localization, refer 
to the HP BASIC 6.2 Porting and Globalization manual. For 
LANGUAGE specific details, refer to Using LanguageX With 
HP BASIC, where LanguageX is your local language. 
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PRINTALL IS 


Supported on 
Option Required 
Keyboard Executable 
Programmable 
In an IF ... THEN .. 


UX WS DOS 

None 

Yes 

Yes 

Yes 


This statement assigns a logging device, file or pipe for recording operator 
interaction and troubleshooting messages. 
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Item 

Description 

Range 

device selector 

numeric expression, rounded to an 
integer; Default = CRT 

(see Glossary) 

file specifier 

string expression 

- 

end-of-line 

characters 

string expression; Default = CR/LF 

0 through 8 characters 

seconds 

numeric expression, rounded to the 
nearest 0.001 seconds; Default = 0 

0.001 through 32.767 

line width 

numeric expression, rounded to an 
integer; Default = infinity (see text) 

1 through 32 767 

exchange string 

string expression 

choices depend on 
LANGUAGE 

shift in string 

string expression 

depends on printer used; six 
bytes maximum 

shift out string 

string expression 

depends on printer used; six 
bytes maximum 

directory path 

literal 

(see MASS STORAGE IS) 

file name 

literal 

depends on volume’s format 
(see Glossary) 

LIF protect 
code 

literal; first two non-blank characters 
are significant 

> not allowed 

SRM password 

literal; first 16 non-blank characters 
are significant 

> not allowed 

volume specifier 

literal 

(see MASS STORAGE IS) 
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Example Statements 


PRINTALL 

PRINTALL 

PRINTALL 

PRINTALL 


IS 

IS 

IS 

IS 


701 

Gpio 

701;E0L CHR$(13) END,WIDTH 65 
614 


PRINTALL IS 
PRINTALL IS 
PRINTALL IS 
PRINTALL IS 
PRINTALL IS 


"debug.out" 

"I fold | pr -e -08 | lp" 

"debug.out";APPEND 
701;EXCHANGE "HP-16" 

701;EXCHANGE "JIS" SHIFT IN In$ OUT Out$ 


BASIC/UX in X Windows 
only 

BASIC/UX only 


Semantics 

PRINTALL IS defines a device or file as the destination for for logging certain 
messages. You can turn PRINTALL logging on and off using the Print All 
or (prt all] key. An asterisk (*) is displayed on the softkey label if PRINTALL 
is on. 

When PRINTALL is on, all items generated by DISP, all operator input 
followed by the [Return 1 , (enter) , [continue! , or [execute! key, and all error 
messages from the computer are logged. All TRACE activity is logged if 
tracing is enabled. 

At power-on and SCRATCH A, the default printall device is the CRT (select 
code 1). 


The EOL Attribute (Requires 10) 

The EOL attribute re-defines the end-of-line (EOL) sequence, which is sent 
at the following times: after the number of characters specified by line width 
and after each line of text. Up to eight characters may be specified as the 
EOL characters; an error is reported if the string contains more than eight 
characters. If END is included in the EOL attribute, an interface-dependent 
END indication is sent with the last character of the EOL sequence. If DELAY 
is included, the computer delays the specified number of seconds (after sending 
the last character) before continuing. The default EOL sequence consists of a 
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carriage-return and a line-feed character with no END indication and no delay 
period. 

The WIDTH Attribute (Requires 10) 

The WIDTH attribute specifies the maximum number of characters 
which will be sent to the printing device or file before an EOL sequence is 
automatically sent. The EOL characters are not counted as part of the line 
width. The default width for the Model 226 CRT is 50, Model 237 and other 
high-resolution displays is 128, and the default for all other devices or file is 80. 
Specifying WIDTH OFF sets the width to infinity. If the default is desired, 
it must be restored explicitly. If the USING clause is included in the PRINT 
statement, the WIDTH attribute is ignored. 

PRINTALL IS file 

The file must be a BDAT, DFS, or HP-UX file. 

The PRINTALL IS file statement positions the file pointer to the beginning 
of the file unless you specify the APPEND option. Thus, PRINTALL IS 
overwrites an existing file unless you specify APPEND. The file is closed when 
another PRINTALL IS statement is executed and at SCRATCH A. 

You can read the file with ENTER if it is ASSIGNed with FORMAT ON. An 
end-of-file error occurs when the end of a LIF file is reached. 

If you are using a version of BASIC that supports wildcards, you can use them 
in file specifiers with PRINTALL IS. You must first enable wildcard recognition 
using WILDCARDS. Refer to the keyword entry for WILDCARDS for details. 
Wildcard file specifiers used with PRINTALL IS must match one and only one 
file name. 

SRM, DFS, and HFS Files 

In order to write to a PRINTALL IS file on a DFS or an HFS volume, you 
need to have R (read) and W (write) permission on the file, and X (search) 
permission on all superior directories. 

In order to write to a PRINTALL IS file on an SRM volume, you need to have 
READ and WRITE capabilities on the immediately superior directory, as well 
as READ capabilities on all other superior directories. 


P-74 PARITY-PURGE 



PRINTALL IS 


No end-of-file error occurs when writing to a file on an SRM, DFS, or HFS 
volume because these files are extensible. That is, if the data output to the file 
with this statement would otherwise overflow the file’s space allocation, the 
BASIC system automatically allocates the additional space needed (provided 
the media contains enough unused storage space). 

If the specified file is in the SRM printer spooler directory, is of type BDAT, 
and contains data, then the SRM system sends the data to the printer (after 
the file is closed) and then purges the file. The SRM printer spooler will also 
spool ASCII files, which can be written by BASIC using OUTPUT, SAVE or 
RE-SAVE. 

You may close the file by executing another PRINTALL IS statement, or a 
SCRATCH A or SCRATCH BIN command. The SRM printer spooler will also 
spool ASCII files, which can be written by BASIC using OUTPUT, SAVE or 
RE-SAVE. 

BASIC/UX Specifics 

On HP-UX systems, the line-printer is a spooled device. Writing directly to the 
printer a:* 701 may • nterfere with other spooled output. It is recommended that 
PRINTALL IS output be directed to either a file or the line-printer spooler by, 
for example, the statement: 

PRINTALL IS M |lp" 

BASIC/UX treats output to a pipe as it would output to a file. The pipe 
must be explicitly closed before any output becomes permanent (or takes 
place). Output to a spooled device will not be sent to the spooler until the 
pipe has been closed. The closing of pipes can be achieved with a subsequent 
PRINTALL IS, QUIT, or SCRATCH A command. 

If PRINTALL IS device is a window and that window is destroyed (with 
DESTROY WINDOW), PRINTALL IS is undefined and generates an error. 
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Using EXCHANGE and SHIFT IN ... OUT (Requires LANGUAGE) 

Some localized versions of BASIC, such as Japanese localized BASIC, support 
two-byte characters. The secondary keyword EXCHANGE allows you to 
automatically convert internal HP-15 character codes to the codes supported 
by your two-byte printer. The available choices and default values for exchange 
string depend on the particular LANGUAGE localization binary that you are 
using. You can turn the EXCHANGE function off by specifying EXCHANGE 
OFF. If you specify EXCHANGE without an exchange string, "HP-16" is 
assumed. 

The secondary keywords SHIFT IN and OUT are useful with certain printers 
that use special control strings to turn two-byte printing on and off. BASIC 
automatically sends the specified shift in string before two-byte characters. 
BASIC also sends the specified shift out string before one-byte characters that 
follow two-byte characters. 


Note SHIFT IN and SHIFT OUT cause Error 257 if used with 

HP-15 characters. Use EXCHANGE to convert HP-15 
characters to your LANGUAGE two-byte characters. 


For a general discussion of globalization and localization including printers, 
refer to the HP BASIC 6.2 Porting and Globalization manual. For 
LANGUAGE specific details, refer to Using LanguageX with HP BASIC, where 
LanguageX is your local language. 
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PRINTER IS 


Supported On 
Option Required 
Keyboard Executable 
Programmable 


In an IF ... THEN ... 


UX WS DOS IN 

None 

Yes 

Yes 

Yes 


This statement specifies the system printing device, file, or pipe. 
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literal form of file specifier: 
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SHIFT M 


shift in 
string 


OUT 


shift out 
string 


> 
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Item 

Description 

Range 

file specifier 

string expression 

i 

- 

device selector 

numeric expression, rounded to an 
integer 

(see Glossary) 

end-of-line 

characters 

string expression; Default = CR/LF 

0 through 8 characters 

seconds 

numeric expression, rounded to the 
nearest 0.001 seconds; Default=0 

0.001 through 32.767 

line width 

numeric expression, rounded to an 
integer; Default = (see text) 

1 through 32 767 

exchange string 

string expression 

choices depend on 
LANGUAGE 

shift in string 

string expression 

depends on printer used; six 
bytes maximum 

shift out string 

string expression 

depends on printer used; six 
bytes maximum 

directory path 

literal 

(see MASS STORAGE IS) 

file name 

literal 

depends on volume’s format 
(see Glossary) 

LIF protect 
code 

literal; first two non-blank characters 
are significant 

> not allowed 

SRM password 

literal; first 16 non-blank characters 
are significant 

> not allowed 

volume specifier 

literal 

(see MASS STORAGE IS) 
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Example Statements 


PRINTER IS 701 

PRINTER IS 614 

PRINTER IS Gpio 

PRINTER IS "debug.out” 

PRINTER IS 701;E0L CHR$(13) END,WIDTH 65 

PRINTER IS "Myfile";WIDTH 80 
PRINTER IS "Spooler:REM0TE" 

PRINTER IS "My_dir/Temp_print";WIDTH 80 
PRINTER IS " | fold | pr -e -o8| lp" 

PRINTER IS "MyBDATfile";APPEND 
PRINTER IS 701;EXCHANGE "HP-16" 

PRINTER IS 701;EXCHANGE "JIS" SHIFT IN In$ OUT Out$ 


BASIC/UX in X only 


BASIC/UX only 


Semantics 

The system printing device or file receives all data sent by the PRINT 
statement and all data sent by CAT, LIST, and XREF statements in which the 
destination is not explicitly specified. 

The default printing device is the CRT (select code 1) at power-on and after 
executing SCRATCH A. 


Using the EOL Attribute (Requires 10) 

The EOL attribute re-defines the end-of-line (EOL) sequence, which is sent 
at the following times: after the number of characters specified by line width, 
after each line of text, and when an “L” specifier is used in a PRINT USING 
statement. Up to eight characters may be specified as the EOL characters; 
an error is reported if the string contains more than eight characters. If END 
is included in the EOL attribute, an interface-dependent END indication is 
sent with the last character of the EOL sequence. If DELAY is included, 
the computer delays the specified number of seconds (after sending the 
last character) before continuing. The default EOL sequence consists of a 
carriage-return and a line-feed character with no END indication and no delay 
period. END and DELAY are ignored for files. 
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The WIDTH Attribute (Requires 10) 

The WIDTH attribute specifies the maximum number of characters which will 
be sent to the printing device before an EOL sequence is automatically sent. 
The EOL characters are not counted as part of the line width. The default 
width for the Model 226 CRT is 50, Model 237 and other high-resolution 
displays is 128, and the default for all other devices is 80. Specifying WIDTH 
OFF sets the width to infinity. If the default is desired, it must be restored 
explicitly. If the USING clause is included the PRINT statement, the WIDTH 
attribute is ignored. Default WIDTH for files is OFF. 

PRINTER IS file 

The file must be a BDAT, DFS, or HP-UX file. 

The PRINTER IS file statement positions the file pointer to the beginning of 
the file unless you specify the APPEND option. Thus, PRINTER IS overwrites 
existing files unless you specify APPEND. The file is closed when another 
PRINTER IS statement is executed and at SCRATCH A. 

If you are using a version of BASIC that supports wildcards, you can use them 
in file specifiers with PRINTER IS. You must first enable wildcard recognition 
using WILDCARDS. Refer to the keyword entry for WILDCARDS for details. 
Wildcard file specifiers used with PRINTER IS must match one and only one 
file name. 

You can read the file with ENTER if it is ASSIGNed with FORMAT ON. An 
end-of-file error occurs when the end of a LIF file is reached. 

SRM, DFS, and HFS Files 

In order to write to a PRINTER IS file on a DFS or an HFS volume, you 
need to have R (read) and W (write) permission on the file, and X (search) 
permission on all superior directories. 

In order to write to a PRINTER IS file on an SRM volume, you need to have 
READ and WRITE capabilities on the immediately superior directory, as well 
as READ capabilities on all other superior directories. 

No end-of-file error occurs when writing to a file on an SRM, DFS, or HFS 
volume because these files are extensible. That is, if the data output to the file 
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with this statement would otherwise overflow the file’s space allocation, the 
BASIC system automatically allocates the additional space needed (provided 
the media contains enough unused storage space). 

If the specified file is in the SRM printer spooler directory, is of type BDAT, 
and contains data, then the SRM system sends the data to the printer (after 
the file is closed) and then purges the file. 

You may close the file by executing another PRINTER IS statement, or a 
SCRATCH A or SCRATCH BIN command. 

BASIC/UX Specifics 

On HP-UX systems, the line-printer is a spooled device. Writing directly to the 
printer as 701 may interfere with other spooled output. It is recommended 
that printer output be directed to either a file or the line-printer spooler by, for 
example, the statement: 

PRINTER IS "|lp" 

BASIC/UX treats output to a pipe as it would output to a file. The pipe must 
be explicitly closed before any output becomes permanent (or takes place). 
Output to a spooled device will not be sent to the spooler until the pipe has 
been closed. The closing of pipes can be achieved with a subsequent PRINTER 
IS, QUIT, or SCRATCH A command. 

Using EXCHANGE and SHIFT IN ... OUT (Requires LANGUAGE) 

Some localized versions of BASIC, such as Japanese localized BASIC, support 
two-byte characters. The secondary keyword EXCHANGE allows you to 
automatically convert internal HP-15 character codes to the codes supported 
by your two-byte printer. The available choices and default values for exchange 
string depend on the particular LANGUAGE localization binary that you are 
using. You can turn the EXCHANGE function off by specifying EXCHANGE 
OFF. If you specify EXCHANGE without an exchange string, "HP-16” is 
assumed. 

The secondary keywords SHIFT IN and OUT are useful with certain printers 
that use special control strings to turn two-byte printing on and off. BASIC 
automatically sends the specified shift in string before two-byte characters. 
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BASIC also sends the specified shift out string before one-byte characters that 
follow two-byte characters. 

Note SHIFT IN and SHIFT OUT cause Error 257 if used with 

HP-15 characters. Use EXCHANGE to convert HP-15 
characters to your LANGUAGE two-byte characters. 


For a general discussion of globalization and localization including printers, 
refer to the HP BASIC 6.2 Porting and Globalization manual. For 
LANGUAGE specific details, refer to Using LanguageX with HP BASIC where 
LanguageX is your local language. 
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p PRINT LABEL 

Supported on UX WS DOS 

Option Required MS 

Keyboard Executable Yes 

Programmable Yes 

In an IF ... THEN ... Yes 

This statement gives a name to a mass storage volume. 



Item Description Range 

volume label name to be given to the volume — 

volume specifier string expression; Default=the (see MASS STORAGE IS) 

default mass storage unit 

Example Statements 

PRINT LABEL "Vers3" TO INTERNAL,4,0" 

PRINT LABEL Vol_label$ TO Vol.specifier$ 

Semantics 

The new name overwrites any previous name for the volume. 

The volume label can be zero to six characters in length consisting of letters 
and numbers. For maximum interchange, the characters should be limited to 
upper-case letters (A-Z) and digits (0-9) with the first character being a letter. 

You cannot use PRINT LABEL with SRM volumes; instead, you will have to 
name the volume at the SRM console. 
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BASIC/UX Specifics 

PRINT LABEL does not work in BASIC/UX for HFS. 

BASIC/DOS Specifics 

PRINT LABEL is not supported for DFS. 
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Supported On 
Option Required 
Keyboard Executable 
Programmable 


In an IF ... THEN ... 


TJX WS DOS 

CRTX 

Yes 

Yes 

Yes 


This statement sets the pen color or gray value to be used in the output area 
and display line of the CRT. 



Item 

Description / Default 

Range Restrictions 

pen value 

numeric expression 

— 


Example Statements 

PRINT PEN Pen_value 
PRINT PEN 143 

IF Color.blue THEN PRINT PEN 141 

Semantics 

The set of alpha colors is given in the table below: 
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Value 

Result 

< 16 

The number is evaluated 

MOD 8 and resulting values 
produce the following: 

0—black 

1— white 

2— red 

3— yellow 

4— green 

5— cyan 

6— blue 

7— magenta 

16 to 135 

Ignored 

136 

White 

137 

Red 

138 

Yellow 

139 

Green 

140 

Cyan 

141 

Blue 

142 

Magenta 

143 

Black 

144 to 255 

Ignored 


This statement has no effect on single plane monochrome displays. On gray 
scale (multi-plane monochrome displays) this statement changes the display 
color to a different shade of gray. 

For displays with bit-mapped alpha, PRINT PEN specifies the graphics pen to 
be used for subsequent alpha output. The range of values allowed with this 
statement are 0 through 255; these values are treated as MOD 2" rc where n is 
the number of display planes. 

PRINT PEN n and CONTROL CRT ,15 ; n set the value of CRT control register 
15. These statements have no effect on control registers 16 and 17 which are 
set using KEY LABELS PEN and KBD LINE PEN, respectively. 

Note that the functionality of this statement can be achieved through CRT 
CONTROL register 15. 
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See the SYSTEM PRIORITY statement. 
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PROTECT 

Supported On UX WS 

Option Required None 

Keyboard Executable Yes 

Programmable Yes 

In an IF ... THEN ... Yes 


This statement specifies the protect code used on PROG, BDAT, and BIN 
files on LIF volumes. It also specifies passwords used on all types of files and 
directories on SRM volumes. (See PERMIT for access permissions of files and 
directories on HFS or SRM/UX volumes.) 


feoTEcfr r-l 


new UF 
protect code 


L_j 

SRM file 


M 

specifier 







SRM directory 
specifier 




o 


< WRITE y ~*\ 

Undelete)--* 


literol form of file specifier: 



literol form of directory specifier 



HFS or SRM files only 
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Item 

Description 

Range 

LIF file 
specifier 

string expression 

(see “file specifier” drawing) 

new LIF 
protect code 

string expression; first two non-blank 
characters are significant 

“>” not allowed 

SRM file 
specifier 

string expression 

(see “file specifier” drawing) 

SRM directory 
specifier 

string expression 

(see “directory specifier” 
drawing) 

new SRM 
password 

literal; first 16 characters are 
significant 

any valid SRM password 
(see Glossary) 

directory path 

literal 

(see MASS STORAGE IS) 

file name 

literal 

depends on volume’s format 
(see Glossary) 

volume specifier 

literal 

(see MASS STORAGE IS) 

directory name 

literal 

depends on volume’s format 
(see Glossary) 


Example Statements 

PROTECT Name$,Lif_pc$ 

PROTECT "George<xy>:INTERNAL","NEW" 

PROTECT "dir:REMOTE",("mgr":MANAGER),("rw":READ,WRITE) 
PROTECT "File<rw>",("rw":DELETE) 


Semantics 
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LIF Files 

A protect code is necessary only for operations which write to a file or PURGE 
a file. The file can always be read without using the protect code (by LOAD, 
COPY, CAT “file name”, etc.) The protect code is required for ASSIGN (and 
therefore ENTER) since ASSIGN opens a file for both read and write. 

Protect codes are “trimmed” before they are used. Therefore, leading and 
trailing blanks are insignificant. To remove a protect code from a file, assign a 
protect code that is the null string or contains all blanks. 

SRM Files (Requires SRM and DCOMM) 

PROTECT allows you to control access to SRM files and directories by 
protecting access capabilities with password(s). Access capabilities are either 
public (available to all SRM users) or password-protected (available only to 
users supplying the correct password with the file or directory specifier). 

The three access capabilities—MANAGER, READ and WRITE—are public 
until the PROTECT statement associates a password with one or more of 
those capabilities. 

Once the capability on a given file or directory is password-protected, the 
capability can be exercised on the file or directory only if the correct password 
is included in the file or directory specifier. For instance, if a file’s READ 
capabilities are protected, any user wishing to execute a command or statement 
that reads the file must supply a password protecting the file’s READ 
capability. 

SRM/UX does not support the PROTECT statement, and will give Error 62 if 
PROTECT is used. Use PERMIT to control access to SRM/UX files. 

MANAGER Access Capability (SRM) 

Public MANAGER capability allows any SRM user to PROTECT, PURGE 
or RENAME a file or directory. Password-protected MANAGER capability 
provides READ and WRITE, as well as MANAGER, access capabilities to 
users who know the password. 
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You must have MANAGER capabilities on a file or directory to PROTECT the 
access capabilities on that file or directory. This includes adding, deleting and 
changing passwords. 

READ Access Capability (SRM) 

READ capability on a file allows use of commands and statements that read 
the contents of a file (for example: ENTER, LOAD, GET). READ capability 
on a directory allows you to read the files in the directory (CAT), or to “pass 
through” a directory by including the directory name (and password, if 
assigned) in a directory path. 

WRITE Access Capability (SRM) 

WRITE capability on a file allows use of commands and statements that 
write to the file (for example: OUTPUT, RE-SAVE, RE-STORE). WRITE 
capability on a directory allows use of commands that add or delete file names 
in the directory (for example: SAVE, STORE, PURGE, CREATE, RENAME). 

Use of PROTECT on SRM 

Each PROTECT statement allows up to six password/capability combinations 
per statement. The number of PROTECT statements that can be executed for 
each file or directory is unlimited, however, as long as each password is unique. 

Successive associations of capabilities with the same password are not 
cumulative. To retain previous capability assignments for a file or directory, 
you must include those assignments in subsequent PROTECT statements 
designating the same password for that file or directory. 

Assume you protected the READ access capability on a file with the password 
passme then wanted to change that assignment so that passme would protect 
both the READ and WRITE access capabilities for that file. If you executed a 
second PROTECT statement associating passme with the WRITE capability 
only, passme would no longer protect the READ capability. Instead, you 
should specify the password and both the READ and WRITE capabilities in 
the second PROTECT statement. 
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To modify the access capabilities protected by a password, execute the 
PROTECT with the existing password and the new password/capability 
pair(s). 

The secondary keyword DELETE is used to delete existing password 
assignments for a file or directory. To be effective, DELETE must be the only 
secondary keyword used with a password/capability pair in the PROTECT 
statement. Otherwise, DELETE is ignored. MANAGER capability is required 
to perform the DELETE. A DELETE executed without MANAGER capability 
results in a protect code violation error. 

PROTECT with WILDCARDS 

If you are using a version of BASIC that supports wildcards, you can use them 
in file specifiers with PROTECT. You must first enable wildcard recognition 
using WILDCARDS. Refer to the keyword entry for WILDCARDS for details. 
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PROUND 



Supported On 
Option Required 
Keyboard Executable 
Programmable 


In an IF ... THEN ... 


UX WS DOS IN 

None 

Yes 

Yes 

Yes 


This function returns the value of the argument rounded to the specified 
power-of-ten. 


< PROUND X2H argument HDHTiTI-<LK 


Item 

Description 

Range 

argument 

numeric expression 

— 

power of ten 

numeric expression, rounded to an 

— 


integer 



Example Statements 

Money=PROUND(Result,-2) 

PRINT PROUND(Quantity,Decimal_place) 


Semantics 

COMPLEX arguments are not allowed with this function. 
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PRT 


Supported On 
Option Required 
Keyboard Executable 
Programmable 


In an IF ... THEN ... 


UX WS DOS IN 

None 

Yes 

Yes 

Yes 


This INTEGER function returns 701, the default (factory set) device selector 
for an external printer. 


P 



Example Statements 

PRINTER IS PRT 
OUTPUT PRT;A$ 
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PURGE 


Supported On 
Option Required 
Keyboard Executable 
Programmable 


In an IF ... THEN ... 


UX WS DOS IN 

None 

Yes 

Yes 

Yes 


This statement deletes a file from a directory. On hierarchical-directory 
volumes (such as DFS, HFS and SRM), PURGE deletes an empty directory 
from its superior directory. 
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literal form of directory specifier: 



HFS or SRM files only 


literal form of DFS file specifier: 



literal form of DFS directory specifier. 
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PURGE 


Item 

Description 

Range 

file specifier 

string expression 

(see drawing) 

directory 

specifier 

string expression 

(see drawing) 

directory path 

literal 

(see MASS STORAGE IS) 

file name 

literal 

depends on volume’s format 
(see Glossary) 

LIF protect 
code 

literal; first two non-blank characters 
are significant 

> not allowed 

SRM password 

literal; first 16 non-blank characters 
are significant 

> not allowed 

volume specifier 

literal 

(see MASS STORAGE IS) 

directory name 

literal 

depends on volume’s format 
(see Glossary) 


Example Statements 


PURGE 

File_name$ 


PURGE 

"File" 


PURGE 

"George<PC>" 


PURGE 

"Dir_a<SRM_RW_pass>/File<MGR_pass>" 


PURGE 

"Dirl/Dir2/Dir3" 


PURGE 

"Monday,?" 

WILDCARDS UX ONLY 

PURGE 

"Dir/Type,[A-Z]" 

WILDCARDS UX ONLY 

Semantics 



Once a file is purged, you cannot access the information which was in the file. 
The records of a purged file are returned to “available space.” 

An open file must be closed before it can be purged. Any file except a 
PRINTER IS file, a PLOTTER IS file, or the current working directory can be 
closed by ASSIGN TO * (see ASSIGN). All files except those opened with the 
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PURGE 


PRINTER IS statement are closed by (reset! ( (shift H pause! or ( Shift H Break! ). 

A PRINTER IS file can be closed by executing a PRINTER IS to another 
device or file. A PLOTTER IS file can be closed by GINIT or PLOTTER IS to 
another device or file. SCRATCH A closes all files. 

If you are using a version of BASIC that supports wildcards, you can use them 
in file specifiers with PURGE. You must first enable wildcard recognition using 
WILDCARDS. Refer to the keyword entry for WILDCARDS for details. 

When PURGE is executed from the keyboard with a wildcard argument that 
matches more than one item, BASIC prompts you to continue, thus ensuring 
safe file purging. BASIC does not prompt you to continue when executing 
PURGE from a program. 

SRM, DFS, and HFS Files and Directories 

In order to PURGE an HFS, DFS, or SRM directory or file, all of the following 
conditions must be met: 

■ It must be closed. The current working directory is closed by an MSI to a 
different directory. SCRATCH A closes all directories and files. 

■ It must be empty (directories only). That is, it must not contain any 
subordinate files or directories. 

■ You must have the appropriate access capabilities. 

□ In order to PURGE a file or directory on an HFS or DFS volume, you 
need to have W (write) and X (search) permission of the immediately 
superior directory, as well as X (search) permission on all other superior 
directories. Note that the ability to purge an HFS or DFS file is not 
determined by the file’s permissions but rather by the permissions set on 
the parent directory. 

□ In order to PURGE a file or directory on an SRM volume, you need to 
have M (manager) access capability on file or directory, as as well as R 
(read) and W (write) capabilities on the immediately superior directory 
and R capability on all superior directories. 
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QUIT 


QUIT 


Q 


Supported On 
Option Required 
Keyboard executable 
Programmable 


In an IF ... THEN ... 


UX DOS WS* 


RMBUX Binary 

Yes 

Yes 

Yes 


This statement exits BASIC for BASIC/UX and BASIC/DOS. The statement 
is accepted by the editor for BASIC/WS, BASIC/UX, or BASIC/DOS, but it 
wil only execute on BASIC/UX or BASIC/DOS. 


Example Statements 

QUIT 

IF A$="DONE" THEN QUIT 


Semantics 

When used within a program, this statement stops the program, and then 
BASIC exits. 

When used as a keyboard command while a program is running, an error is 
given. You must first stop (or pause) the program before using the QUIT 
command. 

If a program is not running, then BASIC is exited immediately. 


Q-2 QUIT 
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RAD 


Supported On 
Option Required 
Keyboard Executable 
Programmable 


In an IF ... THEN ... 


UX WS DOS IN 

None 

Yes 

Yes 

Yes 


This statement selects radians as the unit of measure for expressing angles. 



Semantics 

All functions which return an angle will return an angle in radians. All 
operations with parameters representing angles will interpret the angle in 
radians. If no angle mode is specified in a program, the default is radians (also 
see DEG). 

A subprogram “inherits” the angle mode of the calling context. If the angle 
mode is changed in a subprogram, the mode of the calling context is restored 
when execution returns to the calling context. 
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RANDOMIZE 


RANDOMIZE 


Supported On 
Option Required 
Keyboard Executable 
Programmable 
In an IF ... THEN ... 


UX WS DOS IN 

None 

Yes 

Yes 

Yes 


This statement selects a seed for the RND function. 


(randomize)- 




Item 

Description 

Range 

seed 

numeric expression, rounded to an 
integer; Default = pseudo-random 

1 through 2 31 —2 


Example Statements 

RANDOMIZE 

RANDOMIZE 01d_seed*PI 

Semantics 

The seed actually used by the random number generator depends on the 
absolute value of the seed specified in the RANDOMIZE statement. 
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RANDOMIZE 


Absolute Value 
of Seed 

Value Used 

less than 1 

1 

1 through 2 31 —2 

INT(ABS(seed)) 

greater than 2 31 —2 

2 31 —2 


The seed is reset to 37 480 660 by power-up, SCRATCH A, SCRATCH, and 
program prerun. 


R-4 RAD - RUNLIGHT ON/OFF 




RANK 


RANK 


Supported On 
Option Required 
Keyboard Executable 
Programmable 


In an IF ... THEN ... 


UX WS DOS IN 

MAT 

Yes 

Yes 

Yes 


This function returns the number of dimensions in an array. The value 
returned is an INTEGER. 



Item 

Description 

Range 

array name 

name of an array 

any valid name 


Example Statements 

IF RANK(A )-2 THEN PRINT "A is a matrix" 
R=RANK(Array) 
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RATIO 


Supported On 
Option Required 
Keyboard Executable 
Programmable 


In an IF ... THEN ... 


UX WS DOS 

GRAPH 

Yes 

Yes 

Yes 


This function returns the ratio of the X hard clip limits to the Y hard clip 
limits for the current PLOTTER IS device. 



Example Statements 

WINDOW 0,10*RATI0,-10,10 
Turn=l/RATI0 
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READ 


Supported On 
Option Required 
Keyboard Executable 
Programmable 


In an IF ... THEN ... 


UX WS DOS IN 

None 

Yes 


Yes 


Yes 


This statement reads values from DATA statements and assigns them to 
variables. 
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READ 


Item 

Description 

Range 

numeric name 

name of a numeric variable 

any valid name 

string name 

name of a string variable 

any valid name 

subscript 

numeric expression, rounded to an 
integer 

-32 767 through +32 767 
(see “array” in Glossary) 

beginning 

numeric expression, rounded to an 

1 through 32 767 (see 

position 

integer 

“substring” in Glossary) 

ending position 

numeric expression, rounded to an 
integer 

0 through 32 767 (see 
“substring” in Glossary) 

substring 

numeric expression, rounded to an 

0 through 32 767 (see 

length 

integer 

“substring” in Glossary) 


Example Statements 

READ Number,String$ 

READ Array(*) 

READ ItemCl,1),Item(2,l),Item(3,1) 


Semantics 

The numeric items stored in DATA statements are considered strings by 
the computer, and are processed with a VAL function to read into numeric 
variables in a READ statement. If they are not of the correct form, error 32 
may result. Real DATA items will be rounded into an INTEGER variable 
if they are within the INTEGER range (—32 768 through 32 767). When a 
READ statement contains a COMPLEX variable, that variable is satisfied with 
two REAL values. A string variable may read numeric items, as long as it is 
dimensioned large enough to contain the characters. 

The first READ statement in a context accesses the first item in the first 
DATA statement in the context unless RESTORE has been used to specify a 
different DATA statement as the starting point. Successive READ operations 
access following items, progressing through DATA statements as necessary. 
Trying to READ past the end of the last DATA statement results in error 
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READ 


36. The order of accessing DATA statements may be altered by using the 
RESTORE statement. 

An entire array can be specified by replacing the subscript list with an asterisk. 
The array entries are made in row major order (right most subscript varies 
most rapidly). 
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READIO 


Supported on 
Option Required 
Keyboard Executable 
Programmable 


In an IF ... THEN ... 


UX WS DOS* 

None 

Yes 

Yes 

Yes 


This function reads the contents of the specified hardware register on the 
specified interface, or reads the specified byte or word of memory. 




Item 

Description 

Range 

select code 

numeric expression, rounded to an 

1 through 31, and -31 


integer 

through -1; ±9826; 9827 

register number 

numeric expression, rounded to an 

hardware-dependent 

or memory 

address 

integer 



Note Unexpected results may occur with select codes 9826 and 9827. 


Example Statements 

Upper_byte=READIO(Gpio,4) 

PRINT "Register";I;"=";READIO(7,I) 
Peek_byte=READIO(9826,Mem_addr) 
Var_addr=READIO(9827,Integer_array) 
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READIO 


Semantics 

Positive select codes do a byte read (appropriate for most device registers); 
negative select codes do a word read. 

Reading Memory (“Peek”) 

Select code 9826 is used to read a byte of memory, while —9826 is used to read 
a word (16 bits) of memory. The second parameter specified in the READIO 
function is the memory address of the byte to be read. This parameter is 
interpreted as a decimal address; for instance, an address of 100 000 is KT5, 
not 2 "20. 

Determining the Location of Numeric Variables 

Select code 9827 is used to determine the memory address of a BASIC 
variable. You can use this address, for instance, with WRITEIO to perform a 
JSR (“Jump to Sub Routine”) instruction in machine language, execute the 
instructions contained in the array, and then return to BASIC. (See WRITEIO 
for details.) 

BASIC/UX Specifics 

You are restricted to memory access within your own process space. 

BASIC/DOS Specifics 

Use of READIO or WRITEIO requires specific knowledge of the measurement 
coprocessor hardware. In general, it is recommended that you use STATUS and 
CONTROL instead. 
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READ KEY 


Supported On 

WS 

Option Required 

KBD 

Keyboard Executable 

Yes 

Programmable 

Yes 

In an IF ... THEN ... 

Yes 

This statement reads typing-aid softkey definitions into a string variable. 


(rod KBT>»{.a> 


key string 

number I vorioble ■ ^ 

l string | , 


Item 

Description 

Range 

key number 

numeric expression, rounded to an 
integer 

0 to 23 


Example Statements 

READ KEY 1,A$ 

READ KEY This_key,String$ 
READ KEY Key,Key_array$(*) 


Semantics 

When the string variable is not an array, the single softkey definition specified 
by the key number is read. When the string variable is an array, all the 
typing-aid softkey definitions beginning with the key number specified are read 
into the array. 

The exact size required for the READ KEY string variable depends on the 
the number of characters in the softkey definition of interest. The largest 
typing-aid softkey definition allowed contains 256 bytes of character data per 
softkey. 
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READ KEY 


For more information on typing-aid softkeys, refer to Using HP BASIC/WS 6.2 
or Using HP BASIC/UX 6.2 , and the “Communicating with the Operator” 
chapter of HP BASIC 6.2 Programming Guide. 

Related Commands 

SET KEY, EDIT KEY, LOAD KEY 
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READ LABEL 


Supported on 
Option Required 
Keyboard Executable 
Programmable 
In an IF ... THEN ... 


UX WS DOS* 

MS 

Yes 

Yes 

Yes 


This statement reads a volume label into a string variable. 


C 


READ LABEL 


^ > | string 
J variable 


P 


Item 

Description 

Range 

string variable 

string variable which returns the 
volume name 

— 

volume specifier 

string expression; Default = the 
default mass storage unit 

(see MASS STORAGE IS) 


Example Statements 

READ LABEL Volume_name$ FROM M :INTERNAL,4,1" 

IF Inserted$="Yes" THEN READ LABEL Vol_label$ FROM Vol.specifier$ 


Semantics 

A LIF or HFS volume label consists of a maximum of 6 characters. SRM 
volumes can have labels up to 16 characters. 
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READ LABEL 


BASIC/UX Specifics 

READ LABEL does not work for HFS in BASIC/UX. 

BASIC/DOS Specifics 

READ LABEL is not supported for DFS. 
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READ LOCATOR 


Supported On 
Option Required 
Keyboard Executable 
Programmable 


In an IF ... THEN ... 


UX WS DOS 

GRAPHX 

Yes 

Yes 

Yes 


This statement samples the locator device, without waiting for a digitizing 
operation. 



Item 

Description 

Range 

x coordinate 

name of a numeric variable 

any valid name 

name 



y coordinate 

name of a numeric variable 

any valid name 

name 



string name 

name of a string variable 

any valid name 


Example Statements 

READ LOCATOR X_pos,Y_pos 
READ LOCATOR X,Y,Status$ 

Semantics 

Executing this statement issues a request to the current locator device to 
return a set of coordinates. The coordinates are sampled immediately, without 
waiting for a digitizing action on the part of the user. GRAPHICS INPUT 
IS is used to establish the current locator device. The returned coordinates 
are in the unit-of-measure currently defined for the PLOTTER IS and 
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READ LOCATOR 


GRAPHICS INPUT IS devices. The unit-of-measure may be default units or 
those defined by either the WINDOW or SHOW statement. If an INTEGER 
numeric variable is specified, and the value returned is out of range, Error 20 is 
reported. 

The optional string variable is used to input the device status of the 
GRAPHICS INPUT IS device. This status string contains eight bytes, defined 
as follows. 


Byte 1: 


Bytes 2, 4, and 6: 
Byte 3: 


Byte 5: 

Bytes 7 and 8: 


Button status; This value represents the status of the 
digitizing button on the locator. A “0” means the 
button is not depressed, and a “1” means the button is 
depressed. This is an unprocessed value, and a “1” does 
not necessarily represent successful digitization. If the 
numeric value represented by this byte is used as the pen 
control value for a PLOT statement, continuous digitizing 
will be copied to the display device. 

commas; used as delimiters. 

Significance of digitized point; “0” indicates that the point 
is outside the PI, P2 limits; “1” indicates that the point 
is outside the viewport, but inside the PI, P2 limits; “2” 
indicates that the point is inside the current viewport 
limits. 

Tracking status; “0” indicates off, “1” indicates on. 

The number of the buttons which are currently down. To 
interpret the ASCII number returned, change the number 
to its binary form and look at each bit. If the bit is “1”, 
the corresponding button is down. If the bit is “0”, the 
corresponding button is not down. 

If the locator device (e.g., stylus or puck) goes out of 
proximity, a “button 7” is indicated in the “button 
number” bytes. The number will be exactly “64”, 
regardless of whether any actual buttons are being held 
down at the time. The HP 9111A always returns “00” in 
bytes 7 and 8. 
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REAL 


Supported On 
Option Required 
Keyboard Executable 
Programmable 


In an IF ... THEN ... 


UX WS DOS IN* 

None 

No 

Yes 

No 


This statement reserves storage for floating-point variables and arrays. (For 
information about the REAL function, see the next entry in the keyword 
dictionary; for information about using REAL as a secondary keyword, see the 
ALLOCATE, COM, DEF FN, or SUB statements.) 



Item 

Description 

Range 

numeric name 

name of a numeric variable 

any valid name 

lower bound 

integer constant; Default = OPTION 

-32 767 through +32 767 


BASE value (0 or 1) 

(see “array” in Glossary) 

upper bound 

integer constant 

-32 767 through +32 767 
(see “array” in Glossary) 
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REAL 


Example Statements 

REAL X,Y,Z 

REAL Array(-128:127,15) 

REAL A(512) BUFFER 

Semantics 

Each REAL variable or array element requires eight bytes of number storage. 
The maximum number of subscripts in an array is six, and no dimension may 
have more than 32 767 elements. 

The total number of REAL variables is limited by the fact that the maximum 
memory usage for all variables—COMPLEX, INTEGER, REAL, and string— 
within any context is 2 24 —1, or 16 777 215, bytes (or limited by the amount of 
available memory, whichever is less). 

Declaring Buffers 

To declare REAL variables to be buffers, each variable’s name must be followed 
by the keyword BUFFER; the designation BUFFER applies only to the 
variable which it follows. 
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REAL (function) 


Supported On 
Option Required 
Keyboard Executable 
Programmable 


In an IF ... THEN ... 


UX WS DOS 

COMPLEX 

Yes 

Yes 

Yes 


This function returns the real part of a COMPLEX number. 



REAL 


argument 




Range 

Item 

Description/Default 

Restrictions 

argument 

numeric expression 

any valid INTEGER, REAL, 
or COMPLEX value 


Example Statements 

X=REAL(Complex_expr) 
Y=REAL(Real_expr) 

Z=REAL(Integer.expr) 
Result=REAL(CMPLX(2.1,-8)) 


Semantics 

An INTEGER or REAL argument is returned unchanged. 
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RECORDS 


RECORDS 

See the TRANSFER statement. 
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RECOVER 

See the ON ... statements. 
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RECTANGLE 


RECTANGLE 


Supported On 
Option Required 
Keyboard Executable 
Programmable 


In an IF ... THEN ... 


UX WS DOS 

GRAPHX 

Yes 

Yes 

Yes 


This statement draws a rectangle. It can be filled, edged, or both. 


( rectangle) —► width KH 


height 




Item 

Description 

Range 

width 

numeric expression 

— 

height 

numeric expression 

— 


Example Statements 

RECTANGLE 4,6 
RECTANGLE 3,-2,FILL,EDGE 

Semantics 

The rectangle is drawn with dimensions specified as displacements from the 
current pen position. Thus, both the width and the height may be negative. 

Which corner of the rectangle is at the pen position at the end of the statement 
depends upon the signs of the parameters: 
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RECTANGLE 


Sign 
of X 

Sign 
of Y 

Corner of Rectangle 
at Pen Position 

+ 

+ 

Lower left 

+ 

- 

Upper left 

- 

+ 

Lower right 

- 

- 

Upper right 


Shape of Rectangle 

A rectangle’s shape is affected by the current viewing transformation. If 
isotropic units are in effect, the rectangle will be the expected shape, but if 
anisotropic units are in effect, the rectangle will be distorted: stretched or 
compressed along the axes. 

RECTANGLE is affected by the PIVOT and PDIR transformations. If a 
rotation transformation and anisotropic units are in effect, the rectangle is 
rotated first, then stretched or compressed along the unrotated axes. 

FILL and EDGE 

FILL causes the rectangle to be filled with the current fill color, and EDGE 
causes the perimeter to be drawn with the current pen color and line type. If 
both FILL and EDGE are specified, the interior will be filled, then the edge 
will be drawn. If neither FILL nor EDGE is specified, EDGE is assumed. 

Rectangles sent to an HPGL plotter are edged but not filled regardless of any 
FILL or EDGE directives on the statement. 
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RECTANGLE 


Applicable Graphics Transformations 



Scaling 

PIVOT 

CSIZE 

LDIR 

PDIR 

Lines (generated by moves and 
draws) 

X 

X 



[4] 

Polygons and rectangles 

X 

X 



X 

Characters (generated by 

LABEL) 



X 

X 


Axes (generated by AXES &: 
GRID) 

X 





Location of Labels 

[1] 

[3] 


[2] 



1 The starting point for labels drawn after lines or axes is affected by scaling. 

2 The starting point for labels drawn after other labels is affected by LDIR. 

3 The starting point for labels drawn after lines or axes is affected by PIVOT. 

4 RPLOT and IPLOT are affected by PDIR. 
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REDIM 


Supported On 
Option Required 
Keyboard Executable 
Programmable 


In an IF ... THEN ... 


UX WS DOS 

MAT 

Yes 

Yes 

Yes 


This statement changes the subscript range of previously dimensioned arrays. 


C 


REDIM 




numeric 

nome 





buffer")-^ 


Item 

Description 

Range 

array name 

name of an array 

any valid name 

lower bound 

numeric expression, rounded to an 

—32 768 through +32 767 


integer; Default=OPTION BASE 
value (0 or 1) 

(see “array” in glossary) 

upper bound 

numeric expression, rounded to an 

—32 768 through +32 767 


integer 

(see “array” in glossary) 


Example Statements 

REDIM Array(5) 

REDIM B(3:5,6,-2:2) 
REDIM Constants$(X,Y,Z) 
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Semantics 

The following rules must be followed when redimensioning an array: 

■ The array to be redimensioned must have a currently dimensioned size 
known to the context (i.e., it must have been implicitly or explicitly 
dimensioned, or be currently allocated, or it must have been passed into the 
context.) 

■ You must retain the same number of dimensions as specified in the original 
dimension statement. 

■ The redimensioned array cannot have more elements than the array was 
originally dimensioned to hold. 

■ You cannot change the maximum string length of string arrays. 

REDIM does not change any values in the array, although their locations will 
probably be different. The REDIM is performed left-to-right and if an error 
occurs, arrays to the left of the array the error occurs in will be redimensioned 
while those to the right will not be. If an array appears more than once in the 
REDIM, the right-most dimensions will be in effect after the REDIM. 
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REM 


Supported On 
Option Required 
Keyboard Executable 
Programmable 


In an IF ... THEN ... 


UX WS DOS IN 

None 

No 

Yes 

No 


This statement allows comments in a program. 



Item 

Description 

Range 

literal 

string constant composed of 
characters from the keyboard, 
including those generated with the 
ANY CHAR key 



Example Program Lines 

100 REM Program Title 
190 ! 

200 IF BIT(Info,2) THEN Branch ! Test overrange bit 

Semantics 

REM must be the first keyword on a program line. If you want to add 
comments to a statement, an exclamation point must be used to mark the 
beginning of the comment. If the first character in a program line is an 
exclamation point, the line is treated like a REM statement and is not checked 
for syntax. 
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REMOTE 


REMOTE 


Supported On 
Option Required 
Keyboard Executable 
Programmable 
In an IF ... THEN ... 


UX WS DOS IN 
10 
Yes 
Yes 
Yes 


This statement places HP-IB devices having remote/local capabilities into the 
remote state. 


Q REMOTE 



Item 

Description 

Range 

I/O path name 

name assigned to a device Or devices 

any valid name (see 

ASSIGN) 

device selector 

numeric expression, rounded to an 
integer 

(see Glossary) 


Example Statements 

REMOTE 712 
REMOTE fiHpib 

Semantics 

If individual devices are not specified, the remote state for all devices on the 
bus having remote/local capabilities is enabled. The bus configuration is 
unchanged, and the devices switch to remote if and when they are addressed to 
listen. If primary addressing is used, only the specified devices are put into the 
remote state. 
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REMOTE 


When the computer is the system controller and is switched on, reset, or 
ABORT is executed, bus devices are automatically enabled for the remote state 
and switch to remote when they are addressed to listen. 

The computer must be the system controller to execute this statement, and it 
must be the active controller to place individual devices in the remote state. 


Summary of Bus Actions 



Interface Select Code Only 

Primary Address Specified 

Active 

REN 

REN 

Controller 

ATN 

ATN 



MTA 



UNL 



LAG 

Not Active 
Controller 

REN 

Error 
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REN 


REN 


Supported On 
Option Required 
Keyboard Executable 
Programmable 


In an IF ... THEN ... 


UX WS DOS IN 

None 

Yes 

No 

No 


This command allows you to renumber all or a portion of the program 
currently in memory. 



R 


Summary of Bus Actions 


Item 

Description 

Range 

starting value 

integer constant identifying a 
program line; Default =10 

1 through 32 766 

increment 

integer constant; Default = 10 

1 through 32 767 

beginning line 
number 

integer constant identifying program 
line 

1 through 32 766 

beginning line 
label 

name of a program line 

any valid name 

ending line 
number 

integer constant identifying program 
line; Default = last program line 

1 through 32 766 

ending line 
label 

name of a program line 

any valid name 
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REN 


Example Statements 

REN 

REN 1000,5 

REN 270,1 IN 260,Label1 

Semantics 

The program segment to be renumbered is delimited by the beginning line 
number or label (or the first line in the program) and the ending line number 
or label (or the last line in the program). The first line in the renumbered 
r segment is given the specified starting value, and subsequent line numbers are 
separated by the increment. If a renumbered line is referenced by a statement 
(such as GOTO or GOSUB), those references will be updated to reflect the 
new line numbers. Renumbering a paused program causes it to move to the 
stopped state. 

REN cannot be used to move lines. If renumbering would cause lines to overlap 
preceding or following lines, an error occurs and no renumbering takes place. 

If the highest line number resulting from the REN command exceeds 32 766, 
an error message is displayed and no renumbering takes place. An error occurs 
if the beginning line is after the ending line, or if one of line labels specified 
doesn’t exist. 
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RENAME 


RENAME 


Supported on 
Option Required 
Keyboard Executable 
Programmable 


In an IF ... THEN ... 


UX WS DOS IN 

None 

Yes 

Yes 

Yes 


This statement changes a file’s or directory’s name. 
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RENAME 


(rename 



literol form of file specifier: 



literol form of directory specifier: 



HFS or SRM files only 


literal form of DFS file specifier: 


-O 


\_ 


_w/ 

II 


itl 



directory 

M 

■ ■ 

lSBB!l 


specifier 


-*Ch 


literal form of DFS directory specifier: 
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RENAME 


Item 

Description 

Range 

old file specifier 

string expression 

(see “file specifier” drawing) 

new file 
specifier 

string expression 

(see “file specifier” drawing) 

old directory 
specifier 

string expression 

(see “directory specifier” 
drawing) 

new directory 
specifier 

string expression 

(see “directory specifier” 
drawing) 

directory path 

literal 

(see MASS STORAGE IS) 

file name 

literal 

depends on volume’s format: 
10 characters for LIF; 14 
characters for HFS (short 
file name); 255 characters 
for HFS (long file name); 16 
characters for SRM; (see 
Glossary) 

LIF protect 
code 

literal; first two non-blank characters 
are significant 

> not allowed 

SRM password 

literal; first 16 non-blank characters 
are significant 

> not allowed 

volume specifier 

literal 

(see MASS STORAGE IS) 

directory name 

literal 

depends on volume’s format: 
10 characters for LIF; 14 
characters for HFS (short 
file name); 255 characters 
for HFS (long file name); 16 
characters for SRM; (see 
Glossary) 


RAD - RUNLIGHT ON/OFF R-35 


RENAME 


Example Statements 

RENAME "Old.name" TO "New.name" 

RENAME File_name$fcVol$ TO Temp$ 

RENAME M TEMP<pc>" TO "FINAL" 

RENAME Dir$feFile$&Volume$ 

RENAME "/WORKSTATIONS/AUTOST" TO "old.autost" 

RENAME "Dirl<SRM_RW_pass>/Fl<MGR_pas8>" TO "Dir2<RW_pas8>/Fl" 

RENAME "Dirl/Dir2/MoveFile:REMOTE" TO "./Dir3/To0therDir" 

Semantics 

The new file or directory name must not duplicate the name of any other file in 
the directory. 

SRM files and directories must be closed before being renamed. If an SRM file 
is not closed and you try to rename it you will get an error. 

■ Files are closed by ASSIGN ... TO * (explicitly closes an I/O path). All 
files except those opened with the PRINTER IS statement are also closed by 
f reset ] ( [shift H pause] or [shift H Break 1 ). A PRINTER IS file can be closed by 
executing a PRINTER IS to another device or file. A PLOTTER IS file can 
also be closed by GINIT or PLOTTER IS to another device or file. 

■ The current working directory is closed by an MSI to a different directory. 
SCRATCH A also closes all files and directories. 

If you try to rename an open DFS, HFS or LIF file or directory, you will not 
receive an error. 

Because you cannot move a file from one mass storage volume to another with 
RENAME, an error will be given if a volume specifier is included which is 
not the current location of the file. (However, RENAME can perform limited 
file-move operations with DFS, SRM and HFS files. See details below.) 

If you are using a version of BASIC that supports wildcards, you can use them 
in file specifiers with RENAME. You must first enable wildcard recognition 
using WILDCARDS. Refer to the keyword entry for WILDCARDS for details. 
Wildcard file specifiers used with RENAME must match one and only one file 
name. 
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If you are using a version of BASIC that supports wildcards, you can use them 
in file specifiers with RENAME. You must first enable wildcard recognition 
using WILDCARDS. Refer to the keyword entry for WILDCARDS for details. 
Wildcard file specifiers used with RENAME must match one and only one file 
name. 

LIF Protect Codes 

A protected file retains its old protect code, which must be included in the old 
file specifier. 

DFS and HFS Permissions 

In order to RENAME a file or directory on an HFS or DFS volume, you need 
to have W (write) and X (search) permission of the immediately superior 
directory, as well as X (search) permission on all other superior directories. 


SRM Passwords 

In order to RENAME an SRM file or directory, you need to have M (manager) 
access capability on the file or directory, R (read) and W (write) capabilities 
on the immediately superior directory, and R capabilities on all other superior 
directories. 

Including an SRM password in the file or directory specifier does not protect 
it. You must use PROTECT to assign passwords. You will not receive an error 
message for including a password, but passwords in the “new file/directory 
name” portion of the RENAME statement are ignored. However, any existing 
SRM password is retained by the renamed file or directory. 

SRM File and Directory Specifier Length 

A maximum of nine names (files or directories) are allowed in both file or 
directory specifiers in the RENAME statement. (The number of names in the 
Did file/directory specifier plus the number of names in the new file/directory 
specifier must not exceed nine.) No more than six names are allowed in either 
File specifier individually. 
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Limited File Moves with DFS, SRM and HFS 

With DFS, SRM and HFS, RENAME can be used to move files within the 
directory structure. Directories cannot be moved with RENAME. Moving of 
files must occur within a single volume. If you move a file with RENAME, the 
original file (“old file specifier”) is purged. 

BASIC/UX Specifics 

RENAMEing across HFS volumes is allowed. 
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REORDER 

See the MAT REORDER statement. 
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REPEAT ... UNTIL 


Supported On 
Option Required 
Keyboard Executable 
Programmable 


In an IF ... THEN ... 


UX WS DOS IN 

None 

No 

Yes 

No 


This construct defines a loop which is repeated until the boolean expression in 
the UNTIL statement evaluates to be logically true (evaluates to non-zero). 


( REPEAT y-*~ 



Item 

Description 

Range 

boolean 

expression 

numeric expression; evaluated as true 
if non-zero and false if zero 

— 

program 

segment 

any number of contiguous program 
lines not containing the beginning 
or end of a main program or 
subprogram, but which may contain 
properly nested constructs(s). 



Example Program Segments 

530 REPEAT 
540 PRINT Factor 
550 Factor=Factor*l.l 
560 UNTIL Factor>10 

680 REPEAT 

690 INPUT "Enter a positive number", Number 
700 UNTIL Number>=0 
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Semantics 

The REPEAT ... UNTIL construct allows program execution dependent on 
the outcome of a relational test performed at the end of the loop. Execution 
starts with the first program line following the REPEAT statement, and 
continues to the UNTIL statement where a relational test is performed. If the 
test is false a branch is made to the first program line following the REPEAT 
statement. 

When the relational test is true, program execution continues with the first 
program line following the UNTIL statement. 

Branching into a REPEAT ... UNTIL construct (via a GOTO) results 
in normal execution up to the UNTIL statement, where the test is made. 
Execution will continue as if the construct had been entered normally. 

Nesting Constructs Property 

REPEAT ... UNTIL constructs may be nested within other constructs 
provided the inner construct begins and ends before the outer construct can 
end. 
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REQUEST 


Supported On 
Option Required 
Keyboard Executable 
Programmable 


In an IF ... THEN ... 


UX WS DOS 
10 
Yes 
Yes 
Yes 


This statement is used by a non-active controller to send a Service Request 
(SRQ) on an HP-IB interface. 


(request) -!-^ h-O- 


serial poll 
response byte 


interface 
select code 


Item 

Description 

Range 

I/O path name 

name assigned to an HP-IB interface 

any valid name 

interface select 
code 

numeric expression, rounded to an 
integer 

7 through 31 

serial poll 
response byte 

numeric expression, rounded to an 
integer 

0 through 255 


Example Statements 

REQUEST •Hp_ib;Bit_6+Bit_0 
REQUEST Isc;Response 
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REQUEST 


Semantics 

To request service, the value of the serial poll response must have bit 6 set; this 
bit asserts the SRQ line. SRQ will remain set until either the Active Controller 
performs a Serial Poll or until the computer executes another REQUEST with 
bit 6 clear. 

Only the interface select code may be specified to receive the Request; if a 
device selector that contains address information, or an I/O path assigned to a 
device selector with address information is specified, an error results. An error 
will also results if the computer is currently the Active Controller. 
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RES 


Supported On 
Option Required 
Keyboard Executable 
Programmable 


In an IF ... THEN ... 


UX WS DOS 

None 

Yes 

Yes 

Yes 


This function returns the result of the last numeric computation which was 
executed from the keyboard. 


R 



Example Statements 

RES 

3.5+RES+A 
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RE-SAVE 


Supported On 
Option Required 
Keyboard Executable 
Programmable 


In an IF ... THEN ... 


UX WS DOS IN 

EDIT 

Yes 

Yes 

Yes 


This statement creates a specified ASCII file (or DFS or HP-UX file) if it does 
not exist; otherwise, it re-writes a specified ASCII, DFS, or HP-UX file by 
copying program lines as strings into that file. 




HFS or SRM files only 


literal form of DFS file specifier: 
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Item 

Description 

Range 

file specifier 

string expression 

(see drawing) 

beginning line 
number 

integer constant identifying program 
line; Default = first program line 

1 through 32 766 

beginning line 
label 

name of a program line 

any valid name 

ending line 
number 

integer constant identifying a 
program line; Default = last program 
line 

1 through 32 766 

ending line 
label 

name of a program line 

any valid name 

directory path 

literal 

(see MASS STORAGE IS) 

file name 

literal 

depends on volume’s format 
(see Glossary) 

SRM password 

literal; first 16 non-blank characters 
are significant 

> not allowed 

volume specifier 

literal 

(see MASS STORAGE IS) 


Example Statements 

EE-SAVE "HailFile" 

RE-SAVE Name$,l,Sort 

RE-SAVE ”Dir<SRM_RW_pass>/File<SRM_RW_pass> H 

Semantics 

An entire program can be saved, or the portion delimited by beginning and (if 
needed) ending line labels or line numbers. If the file name already exists, the 
old file entry is removed from the directory after the new file is successfully 
saved on the mass storage media. Attempting to RE-SAVE any existing file 
that is not an ASCII, DFS, or HP-UX text file results in an error. (Note that if 
you RE-SAVE an existing HP-UX text file, a new HP-UX file will be created; 
the same rule applies to existing ASCII and DFS files). 
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If the file does not already exist, RE-SAVE performs the same action as SAVE. 

Pressing (reset 1 during a RE-SAVE operation results in the old file being 
retained. 

If a specified line label does not exist, error 3 occurs. If a specified line number 
does not exist, the program lines with numbers inside the range specified are 
saved. If the ending line number is less than the beginning line number, error 
41 occurs. 

Note that both hard and symbolic links to an HFS file are broken by RE-SAVE 
(see LINK). 

If you are using a version of BASIC that supports wildcards, you can use them 
in file specifiers with RE-SAVE. You must first enable wildcard recognition 
using WILDCARDS. Refer to the keyword entry for WILDCARDS for details. 
Wildcard file specifiers used with RE-SAVE must match one and only one file 
name. 

DFS and HFS Permissions 

In order to RE-SAVE a file on a DFS or HFS volume, you need to have W 
(write) permission on the file (if one already exists), W (write) and X (search) 
permission of the immediately superior directory, as well as X permission on all 
other superior directories. If a file already exists, its permission bits will be 
preserved. 

SRM Access Capabilities 

In order to RE-SAVE an SRM file, you need to have R (read) and W (write) 
access capabilities on the file (if one already exists), R and W capabilities on 
the immediately superior directory, and R capabilities on all other superior 
directories. 

If the file exists and is read/write protected, you must specify the correct 
password with RE-SAVE. If you specify the wrong password on a protected file, 
the system returns an error. Any existing SRM password is retained by the 
re-saved file. 

If the file does not exist, including an SRM password with the file name does 
not protect the file. You must use PROTECT to assign a password. You will 
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RE-SAVE 


not receive an error message for including a password, but a password in the 
file name portion of the RE-SAVE statement will be ignored. 

RE-SAVE on SRM Files 

RE-SAVE opens the remote file in exclusive mode (denoted as LOCK in a CAT 
listing) and enforces that status on the file until the RE-SAVE is complete. 
While in exclusive mode, the file is inaccessible to all SRM workstations other 
than the one executing the RE-SAVE. 

Use of RE-SAVE on SRM and HFS may leave temporary files on the mass 
R storage media if (CLR I/O] ( ( Break 1 ) or [RESET] ( [SHIFT H pause) or [ Shift M Break ) ) 
is pressed or a TIMEOUT occurs during the RE-SAVE. The file name of the 
temporary file is a 10-character name (the first is an alpha character, others 
are digits) derived from the value of the workstation’s real-time clock when 
the interruption occurred. You may wish to check the contents of any such file 
before purging. 

BASIC/UX Specifics 

The temporary file name begins with RMB followed by the last 4 digits of the 
BASIC/UX process id and 3 digits from the system clock. 

If the specified file does not already exist, RE-SAVE will generally create an 
ASCII type file. However, BASIC/UX will create an HP-UX type file when the 
program is being RE-SAVEd to an HFS volume. 

In order to RE-SAVE a file on an HFS volume, you need to have both R (read) 
and W (write) permission on the file if one already exists. The rest of the HFS 
permission requirements are the same as mentioned above. 
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RESET 


Supported On 
Option Required 
Keyboard Executable 
Programmable 
In an IF ... THEN ... 


US WS DOS 
10 
Yes 
Yes 
Yes 


This statement resets an interface or the pointers of either a mass storage file 
or buffer. (For information about RESET as a secondary keyword, see the 
SUSPEND INTERACTIVE statement.) 


I/O path 
name 


interface 
select code 


Item 

Description 

Range 

I/O path name 

name assigned to an interface, mass 
storage file, or buffer 

any valid name 

interface select 

numeric expression, rounded to an 

7 through 31 

code 

integer 



Example Statements 

RESET Hpib 
RESET 20 
RESET ®Buffer_x 
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Semantics 

A RESET directed to an interface initiates an interface-dependent action; see 
the “Interface Registers” section for further details. 

A RESET directed to a mass storage file resets the file pointer to the beginning 
of the file. 

A RESET directed to a buffer resets all registers to their initial values: the 
empty and fill pointers are set to 1, and the current-number-of-bytes and all 
other registers are reset to zero. 

If a TRANSFER is currently being made to or from the specified resource, 
the computer waits until the TRANSFER is complete before executing the 
RESET. If the TRANSFER is not to be completed, an ABORTIO may be 
executed to halt the TRANSFER before executing the RESET. If a busy buffer 
is specified in a RESET statement, error 612 results. 
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RESTORE 


Supported On 
Option Required 
Keyboard Executable 
Programmable 


In an IF ... THEN ... 


UX WS DOS IN 

None 

No 

Yes 

Yes 


RESTORE specifies which DATA statement will be used by the next READ 
operation. 



Item 

Description 

Range 

line label 

name of a program line 

any valid name 

line number 

integer constant identifying a 

1 through 32 766 


program line; Default = first DATA 



statement in context 



Example Statements 

RESTORE 

RESTORE Third.array 


Semantics 

If a line is specified which does not contain a DATA statement, the computer 
uses the first DATA statement after the specified line. RESTORE can only 
refer to lines within the current context. An error results if the specified line 
does not exist. 
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RE-STORE 


Supported On 
Option Required 
Keyboard Executable 
Programmable 
In an IF ... THEN ... 


UX WS DOS 

None 

Yes 

Yes 

Yes 


This statement creates a file and stores the program or typing-aid softkey 
definitions in it. 



literal form of file specifier: 



literal form of DFS file specifier: 
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RE-STORE 


Item 

Description 

Range 

file specifier 

string expression 

(see drawing) 

directory path 

literal 

(see MASS STORAGE IS) 

file name 

literal 

depends on volume’s format 
(see Glossary) 

LIF protect 
code 

literal; first two non-blank characters 
are significant 

> not allowed 

SRM password 

literal; first 16 non-blank characters 
are significant 

> not allowed 

volume specifier 

literal 

(see MASS STORAGE IS) 


Example Statements 

RE-STORE Filename$&Volime$ 

RE-STORE "Prog_a" 

RE-STORE "Dir<SRM_RW_pass>/Prog_z<SRM_RW_pass>" 

RE-STORE KEY "Typing.aids" 

RE-STORE KEY "KEYS:REMOTE" 

Semantics 

If the specified file already exists, the old file is removed from the directory 
after the new file is successfully stored in the current mass storage device. If 
an old file does not exist, a new one is created as if this were the STORE 
statement. 

Pressing f Reset 1 during a RE-STORE operation causes the old file to be 
retained. (See note below for effects on an SRM system.) 

Note that both hard and symbolic links to an HFS file are broken by 
RE-STORE (see LINK). 

If you are using a version of BASIC that supports wildcards, you can use them 
in file specifiers with RE-STORE. You must first enable wildcard recognition 
using WILDCARDS. Refer to the keyword entry for WILDCARDS for details. 
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Wildcard file specifiers used with RE-STORE must match one and only one file 
name. 

LIF Protect Codes 

If the old file had a protect code, the same protect code must be used in the 
RE-STORE operation. Attempting to RE-STORE a file which is the wrong 
type results in an error. (RE-STORE creates a PROG file, and RE-STORE 
KEY creates a BDAT file.) 

DFS and HFS Permissions 

In order to RE-STORE a file on a DFS or HFS volume, you need to have W 
(write) permission on the file (if one already exists), W (write) and X (search) 
permission of the immediately superior directory, as well as X permission on all 
other superior directories. If the file already exists, its permission bits will be 
preserved. 

SRM Access Capabilities 

In order to RE-STORE an SRM file, you need to have R (read) and W (write) 
access capability on the file (if one already exists), R (read) and W (write) 
capabilities on the immediately superior directory, and R capability on all other 
superior directories. 

If the file exists and is read/write protected, you must specify the correct 
password with RE-STORE. If you specify the wrong password on a protected 
file, the system returns an error. Any existing SRM password is retained by the 
re-saved file. 

If the file does not exist, including an SRM password with the file name does 
not protect the file. You must use PROTECT to assign a password. You will 
not receive an error message for including a password, but a password in the 
file name portion of the RE-STORE statement will be ignored. 
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RE-STORE with SRM Volumes 

RE-STORE opens an SRM file in exclusive mode (denoted as LOCK in a CAT 
listing) and enforces that status on the file until the RE-STORE is complete. 
While in exclusive mode, the file is inaccessible to all SRM workstations other 
than the one executing the RE-STORE. 

Use of RE-STORE on SRM or HFS may leave temporary files on the mass 
storage media if fcLR I/O ) ( f Break 1 ) or [reset 1 is pressed or a TIMEOUT occurs 
during the RE-STORE. The file name of the temporary file is a 10-character 
name (the first is an alpha character, others are digits) derived from the value 
of the workstation’s real-time clock when the interruption occurred. You may 
wish to check the contents of any such file before purging. 

BASIC/UX Specifics 

The temporary file name begins with RMB followed by the last 4 digits of the 
BASIC/UX process id and 3 digits from the system clock. 

In order to RE-STORE a file on an HFS volume, you need to have both R 
(read) and W (write) permission on the file if one already exists. The rest of 
the HFS permission requirements are the same as mentioned above. 
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RESUME INTERACTIVE 


Supported On 
Option Required 
Keyboard Executable 
Programmable 
In an IF ... THEN 


UX WS DOS 

None 

Yes 1 

Yes 

Yes 


1 This statement is executable from the keyboard, but only while SUSPEND 
INTERACTIVE is not in effect. 


This statement enables the (execute! , (enter) , (Return) , (pause) , (stop) , (step) , 
(clr i/o) , ( Break ) and ( reset ) keys after a SUSPEND INTERACTIVE statement. 


(resume interactive)-H 


Example Statements 

RESUME INTERACTIVE 

IF Kbd_flag THEN RESUME INTERACTIVE 
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RETURN 


RETURN 


Supported On 
Option Required 
Keyboard Executable 
Programmable 


In an IF... THEN... 


UX WS DOS IN 

None 

No 

Yes 

Yes 


This statement returns program execution to the line following the invoking 
GOSUB. The keyword RETURN is also used in user-defined functions (see 
DEF FN). 

See also ERROR RETURN. 


RETURN 


> 
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RETURN ... 


Supported On 
Option Required 
Keyboard Executable 
Programmable 
In an IF ... THEN ... 


UX WS DOS IN 

None 

No 

Yes 

Yes 


This statement returns a value from a multi-line function. 


C 


DEF FN 


l function 




program 

segment 


( RETURN ^ -r-4 


numeric 

expression 


string 

expression 


Note: A user-defined function 

may contoin any number of 
RETURN statements. 


program 

segment 


( FNEND 


Item 

Description 

Range 

numeric result 

numeric expression 

range of REAL 

string result 

string expression 

— 
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RETURN ... 


Example Statements 

IF D THEM RETURN D 
RETURN A$tB$ 

Semantics 

There may be more than one RETURN statement. The result in the RETURN 
statement is the value returned to the calling context. The result type, numeric 
or string, must match the function type (i.e., a numeric function cannot return 
a string result). 

When you exit a multi-line function, the following actions take place: 

■ local files are closed; 

■ local variables are deallocated; 

■ variables ALLOCATEd in the function are DEALLOCATEd; 

■ ON ... statements may be affected. See ON ... /OFF ... ; 

■ some system variables are restored to previous values. See the “Master Reset 
Table” in the “Useful Tables” section. 
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Supported On 
Option Required 
Keyboard Executable 
Programmable 


In an IF ... THEN ... 


UX WS DOS IN 

None 

Yes 

Yes 

Yes 


This function returns a string formed by reversing the sequence of characters in 
the specified string. 


C revi x th nth 


Example Statements 

Reverse$=REV$("palindrome") 

Last_blank=LEN(Sentences)-POS(REV$(Sentences)") 


Semantics 

The REVS function is useful when searching for the last occurrence of an item 
within a string. 

Two-byte Language Specifics 

Certain localized versions of BASIC, such as Japanese localized BASIC, 
support two-byte characters. The REVS function can handle any 
combination of one- and two-byte characters. The string is reversed on a 
character-by-character basis. For more information about two-byte characters, 
refer to the globalization chapters of HP BASIC 6.2 Porting and Globalization. 
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RND 


Supported on 
Option Required 
Keyboard Executable 
Programmable 


In an IF... THEN... 


UX WS DOS IN 

None 

Yes 

Yes 

Yes 


This function returns a pseudo-random number greater than 0 and less than 1. 



R 


Example Statements 

P ercent=RND*100 
IF RND<.5 THEN Casel 

Semantics 

The random number returned is based on a seed set to 37 480 660 at power-on, 
SCRATCH, SCRATCH A, or program prerun. Each succeeding use of RND 
returns a random number which uses the previous random number as a seed. 
The seed can be modified with the RANDOMIZE statement. 
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ROTATE 


Supported On 
Option Required 
Keyboard Executable 
Programmable 


In an IF ... THEN ... 


UX WS DOS IN 

None 

Yes 

Yes 

Yes 


This function returns an integer which equals the value obtained by shifting the 
16-bit binary representation of the argument by the number of bit positions 
specified. The shift is performed with wrap-around. 



Item 

Description 

Range 

argument 

numeric expression, rounded to an 
integer 

-32 768 through +32 767 

bit position 

numeric expression, rounded to an 

—15 through +15 

displacement 

integer 



Example Statements 

New_word=ROTATE(Old.word,2) 
Q=R0TATE(Q,Places) 


Semantics 

The argument is converted into a 16-bit, two’s-complement form. If the bit 
position displacement is positive, the rotation is towards the least-significant 
bit. If the bit position displacement is negative, the rotation is towards the 
most-significant bit. The rotation is performed without changing the value of 
any variable in the argument. 


R-62 RAD - RUNLIGHT ON/OFF 




RPLOT 


RPLOT 


Supported On 
Option Required 
Keyboard Executable 
Programmable 


In an IF ... THEN ... 


UX WS DOS 

GRAPH 

Yes 

Yes 

Yes 


This statement moves the pen from the current pen position to the point 
specified by adding the x and y displacements to the local origin. It can be 
used to move with or without drawing a line depending on the pen control 
parameter. 



Item 

Description 

Range 

x displacement 

numeric expression in current units 

— 

y displacement 

numeric expression in current units 

— 

pen control 

numeric expression, rounded to an 
integer; Default = 1 

—32 768 through +32 767 

array name 

name of two-dimensional, two-column 
or three-column numeric array. 
Requires GRAPHX 

any valid name 
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Example Statements 

RPLOT Rel_x,Rel_y,Pen_action 
RPLOT 5,12 

RPLOT Shape(*).FILL,EDGE 

Semantics 

This statement moves the pen to the specified X and Y coordinates relative 
to the local coordinate origin. Both moves and draws may be generated, 
depending on the pen control parameter. Lines are drawn using the current 
pen color and line type. 

The local coordinate origin is the logical pen position at the completion of one 
of the following statements. The local coordinate origin is not changed by the 
RPLOT statement. 


AXES DRAW FRAME GINIT GRID IDRAW 

IMOVE IPLOT LABEL MOVE PLOT POLYGON 

POLYLINE RECTANGLE SYMBOL 

The line is clipped at the current clipping boundary. RPLOT is affected by the 
PIVOT and PDIR transformations. If none of the line is inside the current clip 
limits, the pen is not moved, but the logical pen position is updated. 

Non-Array Parameters 

The specified X and Y displacements information is interpreted according to 
the current unit-of-measure. Lines are drawn using the current pen color and 
line type. 

If none of the line is inside the current clip limits, the pen is not moved, but 
the logical pen position is updated. 
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Applicable Graphics Transformations 



Scaling 

PIVOT 

CSIZE 

LDIR 

PDIR 

Lines (generated by moves and 
draws) 

X 

X 



[4] 

Polygons and rectangles 

X 

X 



X 

Characters (generated by 

LABEL) 



X 

X 


Axes (generated by AXES &; 
GRID) 

X 





Location of Labels 

[1] 

[3] 


[2] 



1 The starting point for labels drawn after lines or axes is affected by scaling. 

2 The starting point for labels drawn after other labels is affected by LDIR. 

3 The starting point for labels drawn after lines or axes is affected by PIVOT. 

4 RPLOT and IPLOT are affected by PDIR. 

The optional pen control parameter specifies the following plotting actions; the 
default value is +1 (down after move). 


Pen Control Parameter 


Pen Control 

Resultant Action 

—Even 

Pen up before move 

-Odd 

Pen down before 


move 

+Even 

Pen up after move 

+Odd 

Pen down after 


move 


The above table is summed up by: even is up, odd is down, positive is after 
pen motion, negative is before pen motion. Zero is considered positive. 
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Array Parameters 

When using the RPLOT statement with an array, either a two-column or a 
three-column array may be used. If a two-column array is used, the third 
parameter is assumed to be 4-1; pen down after move. 

FILL and EDGE 

When FILL or EDGE is specified, each sequence of two or more lines forms a 
polygon. The polygon begins at the first point on the sequence, includes each 
successive point, and the final point is connected or closed back to the first 
point. A polygon is closed when the end of the array is reached, or when the 
value in the third column is an even number less than three, or in the range 5 
to 8 or 10 to 15. 

If FILL and/or EDGE are specified on the RPLOT statement itself, it causes 
the polygons defined within it to be filled with the current fill color and/or 
edged with the current pen color. If polygon mode is entered from within 
the array, and the FILL/EDGE directive for that series of polygons differs 
from the FILL/EDGE directive on the RPLOT statement itself, the directive 
in the array replaces the directive on the statement. In other words, if a 
“start polygon mode” operation selector (a 6, 10, or 11) is encountered, any 
current FILL/EDGE directive (whether specified by a keyword or an operation 
selector) is replaced by the new FILL/EDGE directive. 

If FILL and EDGE are both declared on the RPLOT statement, FILL occurs 
first. If neither one is specified, simple line drawing mode is assumed; that is, 
polygon closure does not take place. 

If you attempt to fill a figure on an HPGL plotter, the figure will not be filled, 
but will be edged, regardless of the directives on the statement. 

When using a RPLOT statement with an array, the following table of 
operation selectors applies. An operation selector is the value in the 
third column of a row of the array to be plotted. The array must be a 
two-dimensional, two-column or three-column array. If the third column exists, 
it will contain operation selectors which instruct the computer to carry out 
certain operations. Polygons may be defined, edged (using the current pen), 
filled (using the current fill color), pen and line type may be selected, and so 
forth. 
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Column 1 

Column 2 

Operation 

Selector 

Meaning 

X 

Y 

-2 

Pen up before moving 

X 

Y 

-1 

Pen down before moving 

X 

Y 

0 

Pen up after moving (Same as +2) 

X 

Y 

1 

Pen down after moving 

X 

Y 

2 

Pen up after moving 

pen number 

ignored 

3 

Select pen 

line type 

repeat value 

4 

Select line type 

color 

ignored 

5 

Color value 

ignored 

ignored 

6 

Start polygon mode with FILL 

ignored 

ignored 

7 

End polygon mode 

ignored 

ignored 

8 

End of data for array 

ignored 

ignored 

9 

NOP (no operation) 

ignored 

ignored 

10 

Start polygon mode with EDGE 

ignored 

ignored 

11 

Start polygon mode with FILL and 




EDGE 

ignored 

ignored 

12 

Draw a FRAME 

pen number 

ignored 

13 

Area pen value 

red value 

green value 

14 

Color 

blue value 

ignored 

15 

Value 

ignored 

ignored 

>15 

Ignored 


Moving and Drawing 

If the operation selector is less than or equal to two, it is interpreted in exactly 
the same manner as the third parameter in a non-array RPLOT statement. 
Even is up, odd is down, positive is after pen motion, negative is before pen 
motion. Zero is considered positive. 

Selecting Pens 

An operation selector of 3 selects a pen. The value in column one is the pen 
number desired. The value in column two is ignored. 
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Selecting Line Types 

An operation selector of 4 selects a line type. The line type (column one) 
selects the pattern, and the repeat value (column two) is the length in GDUs 
that the line extends before a single occurrence of the pattern is finished and it 
starts over. On the CRT, the repeat value is evaluated and rounded down to 
the next multiple of 5, with 5 as the minimum. 

Selecting a Fill Color 

Operation selector 13 selects a pen from the color map with which to do 
area fills. This works identically to the AREA PEN statement. Column one 
contains the pen number. 

Defining a Fill Color 

Operation selector 14 is used in conjunction with operation selector 15. Red 
and green are specified in columns one and two, respectively, and column three 
has the value 14. Following this row in the array (not necessarily immediately), 
is a row whose operation selector in column three has the value of 15. The first 
column in that row contains the blue value. These numbers range from 0 to 
32 767, where 0 is no color and 32 767 is full intensity. Operation selectors 14 
and 15 together comprise the equivalent of an AREA INTENSITY statement, 
which means it can be used on a monochromatic, gray scale, or color display. 

Operation selector 15 actually puts the area intensity into effect, but only if an 
operation selector 14 has already been received. 

Operation selector 5 is another way to select a fill color. The color selection is 
through a Red-Green-Blue (RGB) color model. The first column is encoded in 
the following manner. There are three groups of five bits right-justified in the 
word; that is, the most significant bit in the word is ignored. Each group of five 
bits contains a number which determines the intensity of the corresponding 
color component, which ranges from zero to sixteen. The value in each field 
will be sixteen minus the intensity of the color component. For example, if the 
value in the first column of the array is zero, all three five-bit values would 
thus be zero. Sixteen minus zero in all three cases would turn on all three color 
components to full intensity, and the resultant color would be a bright white. 
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Assuming you have the desired intensities (which range from 0 thru 1) for red, 
green, and blue in the variables R, G, and B, respectively, the value for the first 
column in the array could be defined thus: 

Array(Row,1)=SHIFT(16*(l-B),-10)+SHIFT(16*(l-G),-5)+16*(l-R) 

If there is a pen color in the color map similar to that which you request here, 
that non-dithered color will be used. If there is not a similar color, you will get 
a dithered pattern. 

If you are using a gray scale display, Operation selector 5 uses the five bit 
values of the RGB color specified to calculate luminosity. The resulting gray 
luminosity is then used as the area fill. For detailed information on gray 
scale calculations, see the chapter “More About Color Graphics” in the 
HP BASIC 6.2 Advanced Programming Techniques manual. 

Polygons 

A six, ten, or eleven in the third column of the array begins a “polygon mode”. 
If the operation selector is 6, the polygon will be filled with the current fill 
color. If the operation selector is 10, the polygon will be edged with the current 
pen number and line type. If the operation selector is 11, the polygon will 
be both filled and edged. Many individual polygons can be filled without 
terminating the mode with an operation selector 7. This can be done by 
specifying several series of draws separated by moves. The first and second 
columns are ignored and should not contain the X and Y values of the first 
point of a polygon. 

Operation selector 7 in the third column of a plotted array terminates 
definition of a polygon to be edged and/or filled and also terminates the 
polygon mode (entered by operation selectors 6, 10, or 11). The values in the 
first and second columns are ignored, and the X and Y values of the last data 
point should not be in them. Edging and/or filling of the most recent polygon 
will begin immediately upon encountering this operation selector. 
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Doing a FRAME 

Operation selector 12 does a FRAME around the current soft-clip limits. Soft 
clip limits cannot be changed from within the RPLOT statement, so one 
probably would not have more than one operation selector 12 in an array to 
RPLOT, since the last FRAME will overwrite all the previous ones. 

Premature Termination 

Operation selector 8 causes the RPLOT statement to be terminated. The 
RPLOT statement will successfully terminate if the actual end of the array has 
been reached, so the use of operation selector 8 is optional. 

Ignoring Selected Rows in the Array 

Operation selector 9 causes the row of the array it is in to be ignored. Any 
operation selector greater that fifteen is also ignored, but operation selector 
9 is retained for compatibility reasons. Operation selectors less than —2 
are not ignored. If the value in the third column is less than zero, only 
evenness/oddness is considered. 
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RPT$ 


Supported On 
Option Required 
Keyboard Executable 
Programmable 


In an IF... THEN... 


UX WS DOS IN 

None 

Yes 

Yes 

Yes 


This function returns the specified number of repetitions of a string. 


i agg hT)— 


R 


Item 

Description 

Range 

argument 

string expression 

— 

repeat factor 

numeric expression, rounded to an 
integer 

0 through 32 767 


Example Statements 

PRINT RPT$("*",80) 

Center$ ss RPT$(" ", (Right-Left-Length)/2) 


Semantics 

The value of the numeric expression is rounded to an integer. If the numeric 
expression evaluates to a zero, a null string is returned. 

An error will result if the numeric expression evaluates to a negative number or 
if the string created by RPT$ contains more than 32 767 characters. 

Note that RPT$ handles any combination of one- and two-byte characters. 
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See the MAT statement. 
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RUN 


Supported On 
Option Required 
Keyboard Executable 
Programmable 
In an IF ... THEN ... 


UX WS DOS IN 

None 

Yes 

No 

No 


This command starts program execution at a specified line. 



R 


Item 

Description 

Range 

line number 

integer constant identifying a 

1 through 32 766 


program line; Default = first program 



line 


line label 

name of a program line 

any valid name 


Example Statements 

RUN 10 
RUN Part2 

Semantics 

Pressing the (run ) key is the same as executing RUN with no label or line 
number. RUN is executed in two phases: prerun initialization and program 
execution. 

The prerun phase consists of: 
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■ Reserving memory space for variables specified in COM statements (both 
labeled and blank). See COM for a description of when COM areas are 
initialized. 

■ Reserving memory space for variables specified by DIM, REAL, COMPLEX, 
INTEGER, or implied in the main program segment. This does not include 
variables used with ALLOCATE, which is done at run-time. Numeric 
variables are initialized to 0; string variables are initialized to the null string. 

■ Checking for syntax errors which require more than one program line to 
detect. Included in this are errors such as incorrect array references, and 
mismatched parameter or COM lists. 

If an error is detected during prerun phase, prerun halts and an error message 
is displayed on the CRT. 

After successful completion of prerun initialization, program execution begins 
with either the lowest numbered program line or the line specified in the RUN 
command. If the line number specified does not exist in the main program, 
execution begins at the next higher-numbered line. An error results if there is 
no higher-numbered line available within the main program, or if the specified 
line label cannot be found in the main program. 
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RUNLIGHT ON/OFF 


Supported On 
Option Required 
Keyboard Executable 
Programmable 


In an IF ... THEN ... 


UX WS DOS 

CRTX 

Yes 

Yes 

Yes 


This statement turns the runlight indicator at the bottom right of the display 
on and off. 


C 



Example Statements 

RUNLIGHT ON 
RUNLIGHT OFF 

Semantics 

This statement is useful when you want to prevent the runlight indicator from 
appearing on graphics dumps. The default RUNLIGHT setting is ON after 
SCRATCH A, BASIC reset, or power-on. 
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SAVE 


Supported On 
Option Required 
Keyboard Executable 
Programmable 


In an IF ... THEN ... 


UX WS DOS IN 

EDIT 

Yes 

Yes 

Yes 


This statement creates a file and copies program lines as strings into that file. 
In general, SAVE creates an ASCII file. However, BASIC creates a DOS type 
file on a DOS volume, and BASIC/UX creates an HP-UX type file on an HFS 
volume. 



literal form of file specifier: 



HFS or SRM files only 


literal form of DFS file specifier: 
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Item 

Description 

Range 

file specifier 

string expression 

(see drawing) 

beginning line 
number 

integer constant identifying a 
program line; Default = first program 
line 

1 through 32 766 

beginning line 
label 

name of a program line 

any valid name 

ending line 
number 

integer constant identifying a 
program line; Default = last program 
line 

1 through 32 766 

ending line 
label 

name of a program line 

any valid name 

directory path 

literal 

(see MASS STORAGE IS) 

file name 

literal 

depends on volume’s format 
(see Glossary) 

LIF protect 
code 

literal; first two non-blank characters 
are significant 

> not allowed 

SRM password 

literal; first 16 non-blank characters 
are significant 

> not allowed 

volume specifier 

literal 

(see MASS STORAGE IS) 


Example Statements 

SAVE "WHALES" 

SAVE "TEMP",1,Sort 

SAVE "Dir<SRM_RW_pass>/File" 

SAVE "Ascii.file:REMOTE" 
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Semantics 

An entire program can be saved, or any portion delimited by the beginning and 
(if needed) ending line numbers or labels. This statement is for creating new 
files. Attempting to SAVE a file name that already exists causes error 54. If 
you need to replace an old file, see RE-SAVE. 

If a specified line label does not exist, error 3 occurs. If a specified line number 
does not exist, the program lines with numbers inside the range specified are 
saved. If the ending line number is less than the beginning line number, error 
41 occurs. If no program lines are in the specified range, error 46 occurs. 

Lines longer than 256 characters may not be saved correctly. When a GET 
is performed on a program with such a line, an error will occur. However, a 
program containing lines exceeding this length can be successfully STOREd 
and LOADed. 

HFS Permissions 

In order to SAVE a file on an HFS volume, you need to have W (write) and 
X (search) permission of the immediately superior directory, as well as X 
permission on all other superior directories. 

When a file is saved on an HFS volume, access permission bits are set to 
RW-RW-RW-. You can modify the access permission bits with PERMIT if 
desired. For BASIC/UX, these permissions are subject to alteration by the 
user’s umask value, if set. See the HP-UX Reference, umask(l). 

DFS and HFS File Headers 

All ASCII type files on DFS or HFS volumes contain a 512-byte header (at 
the beginning of the file’s contents). This header allows the BASIC system to 
recognize the file as being an ASCII file. (The header is handled automatically 
by the BASIC system, so you do not have to take any special actions.) HP-UX 
type files do not have a header. 
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In order to SAVE an SRM file, you need to have R (read) and W (write) 
capabilities on the immediately superior directory, and R capabilities on all 
other superior directories. 

Including an SRM password with the file name does not protect the file. 

You must use PROTECT to assign passwords. You will not receive an error 
message for including a password, but a password in the file name portion of 
the SAVE statement will be ignored. 

SAVE opens an SRM file in exclusive mode (denoted as LOCK in a CAT listing) 
and enforces that status on the file until the SAVE is complete. While in 
exclusive mode, the file is inaccessible to all SRM workstations other than the 
one executing the SAVE. 
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Supported On WS 

Option Required None 

Keyboard Executable Yes 

Programmable Yes 

In an IF ... THEN ... Yes 


This boolean function returns 1 (true) when the first byte of the string 
argument is a valid second byte in the HP-15 character set. 


C 


SBYTE 


string 

expression 


Example Statements 

IF FBYTE(A$) AND SBYTE(A$[2]) THEN Valid_Hpl5 

Semantics 

Certain localized versions of BASIC, such as Japanese localized BASIC, 
use two-byte characters. Together, FBYTE and SBYTE allow you to 
programmatically determine a whether character is one or two bytes long. Note 
that FBYTE only checks the first byte of the string expression. If FBYTE 
returns 1 (true), you must also test the second byte of the string using SBYTE 
to determine if the second byte is in the valid range for HP-15 characters. 

For a general discussion of globalization and localization including two-byte 
characters, refer to the HP BASIC 6.2 Porting and Globalization manual. To 
determine the values returned by SBYTE for specific characters, refer to Using 
LanguageX with HP BASIC, where LanguageX is your local language. 
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SC 


Supported On 
Option Required 
Keyboard Executable 
Programmable 


In an IF ... THEN ... 


UX WS DOS 

None 

Yes 

Yes 

Yes 


This function returns the interface select code associated with an I/O path 
name. 



Item 

Description 

Range 

I/O path name 

name of a currently assigned I/O 
path 

any valid name 


Example Statements 

Isc=SC(CDevice) 
Drive_isc=SC(fiFile) 


Semantics 

If the I/O path name is assigned to a device selector (or selectors) with 
primary and/or secondary addressing, only the interface select code is returned. 
If the specified 1/O path name is assigned to a mass storage file, the interface 
select code of the drive is returned. If the specified I/O path name is assigned 
to a buffer, a zero is returned. 

If the I/O path name is not currently assigned to a resource, an error is 
reported. 
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BASIC/UX Specifics 

If the I/O path name refers to a file on an HFS disk, SC returns the constant 
value 701. 


S 
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SCRATCH 


Supported On 
Option Required 
Keyboard Executable 
Programmable 


In an IF ... THEN ... 


UX WS DOS IN* 

None 

Yes 

No 

No 


This command erases all or selected portions of memory. 
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Item 

Description 

Range 

key number 

integer constant 

0 through 23 


Example Statements 

SCRATCH 
SCRATCH A 

SCRATCH ALL (BASIC/UX and BASIC/WS only) 

SCRATCH KEY 
SCRATCH KEY 21 

SCRATCH WINDOW (BASIC/UX under X Windows only) 

Semantics 

The BASIC Workstation (BASIC/WS) and BASIC/DOS do not support the 
following secondary keywords with the keyword SCRATCH: 

w 

WINDOW 

Both full names and single character abbreviations for actions are accepted. 

SCRATCH clears the BASIC program and all variables not in COM. Key 
definitions are left intact. 

SCRATCH C clears all variables, including those in COM. The program and 
keys are left intact. 

SCRATCH R clears the (recall) key buffer. 

To scratch a key, type SCRATCH KEY, followed by the key number, and press 
(execute), (enter ) , or ( Return ) . Also, pressing a softkey after typing SCRATCH will 
cause SCRATCH KEY, followed by the key number, to be displayed. When a key 
is specified, the definition for that key only is cleared. When an individual key 
is not specified, all key definitions are cleared. In either case, the program and 
all variables are left intact. 

SCRATCH A clears the BASIC program memory, all the key definitions, 
and all variables (including those in COM). Most internal parameters in the 
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computer are reset by this command. The clock is not reset and the recall 
buffer is not cleared. See the Master Reset Table in the “Useful Tables” section 
in the back of this manual for details. 

SCRATCH BIN 

SCRATCH BIN causes an extended SCRATCH A. It resets the computer to its 
power up state. All programs, variables, and BINs are deleted from memory. 
The BIN which contains the CRT driver for the current CRT is not deleted. 
Note that SCRATCH BIN will not remove any binaries that reside in ROM. 

SCRATCH BIN and SCRATCH B are not supported on BASIC/UX. 

If you execute SCRATCH BIN for the measurement coprocessor, all binaries 
except the CRTB and DFS binaries will be removed. Thus, LOAD BIN can 
subsequently load binaries from the DFS disk files. 

SCRATCH A Effects on SRM and HFS Volumes 

With SRM volumes, SCRATCH A releases the system resources allocated to 
the workstation executing the SCRATCH A, making those resources available 
to other SRM workstations. More specifically, SCRATCH A closes all files and 
directories, and resets the workstation’s working directory to the root directory 
of the default volume (the mass storage volume from which the workstation 
booted). SCRATCH A also closes files and directories with HFS volumes. 

If the workstation has Boot ROM version 3.0 or A or later, and booted 
from the SRM, SCRATCH A resets the working directory to the root of the 
default system volume. If the workstation has an earlier version Boot ROM, 
SCRATCH A resets the working directory to the device from which the 
workstation booted (for example, INTERNAL if the workstation booted from 
a built-in drive). 

SCRATCH W or SCRATCH WINDOW (BASIC/UX only) 

In a windowing environment, this command causes all created windows to be 
destroyed. Note that this does not destroy the root BASIC window. 

This command is only valid when running within a window system. When not 
in a window system, this command causes an error. 
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See the SEND statement 


S-12 SAVE - SYSTEMS 


SECURE 


SECURE 


Supported On 
Option Required 
Keyboard Executable 
Programmable 
In an IF..THEN.. 


UX WS DOS IN 

PDEV 

Yes 

No 

No 


This command protects program lines so that they cannot be listed. There is 
no way to remove this security, once executed. 


( SECURE y 


u 


beginning 
line number 


Kin 


ending 
line number 


Item 

Description 

Range 

beginning line 
number 

integer constant; Default = first line 
in program 

— 

ending line 
number 

integer constant; Default = beginning 
line number if specified, or last line in 

— 


program 



Example Statements 

SECURE 
SECURE 45 
SECURE 1,100 
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Semantics 

If no lines are specified, the entire program is secured. If one line number is 
specified, only that line is secured. If two lines are specified, all lines between 
and including those lines are secured. 

Program lines which are secure are listed as an *. Only the line number is 
listed. 

Caution Do not SECURE the only copy of your program. Make a copy 
of your program, SECURE the copy, and save the original 
“source code” version of your program in a safe place. There 
is no way to “unsecure” a program once you have protected it 
with the SECURE statement. This prevents unauthorized users 
from listing your program. 
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SELECT ... CASE 


Supported On 
Option Required 
Keyboard Executable 
Programmable 


In an IF ... THEN ... 


UX WS DOS IN 

None 

No 

Yes 

No 


This construct provides conditional execution of one of several program 
segments. 
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SELECT ... CASE 


Item 

Description 

Range 

expression 

a numeric or string expression 

— 

match item 

a numeric or string expression; 
must be same type as the SELECT 
expression 


program 

segment 

any number of contiguous program 
lines not containing the beginning 
or end of a main program or 
subprogram, but which may contain 
properly nested construct(s). 



Example Program Segments 

650 SELECT Expression 
660 CASE <0 

670 PRINT "Negative number" 

680 CASE ELSE 

690 PRINT "Non-negative number" 

700 END SELECT 

750 SELECT Expressions 
760 CASE "A" TO "Z" 

770 PRINT "Uppercase alphabetic" 

780 CASE 

790 PRINT "Punctuation" 

800 END SELECT 

Semantics 

SELECT ... END SELECT is similar to the IF ... THEN ... ELSE ... END 
IF construct, but allows several conditional program segments to be defined; 
however, only one segment will be executed each time the construct is entered. 
Each segment starts after a CASE or CASE ELSE statement and ends when 
the next program line is a CASE, CASE ELSE, or END SELECT statement. 

The SELECT statement specifies an expression, whose value is compared to 
the list of values found in each CASE statement. When a match is found, 
the corresponding program segment is executed. The remaining segments are 
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skipped and execution continues with the first program line following the END 
SELECT statement. 

All CASE expressions must be of the same type, (either string or numeric) and 
must agree in type with the corresponding SELECT statement expression. 

The optional CASE ELSE statement defines a program segment to be executed 
when the selected expression’s value fails to match any CASE statement’s list. 

Branching into a SELECT ... END SELECT construct (via GOTO) results 
in normal execution until a CASE or CASE ELSE statement is encountered. 
Execution then branches to the first program line following the END SELECT 
statement. 

Errors encountered in evaluating CASE statements will be reported as having 
occurred in the corresponding SELECT statement. 

Nesting Constructs Properly 

SELECT ... END SELECT constructs may be nested, provided inner 
construct begins and ends before the outer construct can end. 
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SEND 


Supported On 
Option Required 
Keyboard Executable 
Programmable 
In an IF... THEN... 


UX WS DOS 
10 
Yes 
Yes 
Yes 


This statement sends messages to an HP-IB. 
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ASCII space 
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SEND 


Item 

Description 

Range 

interface select 
code 

numeric expression, rounded to an 
integer 

7 through 31 

I/O path name 

name assigned to an interface select 
code 

any valid name (see 

ASSIGN) 

primary 

address 

numeric expression, rounded to an 
integer 

0 through 31 

secondary 

address 

numeric expression, rounded to an 
integer 

0 through 31 


Example Statements 

SEND 7;UNL MTA LISTEN 1 DATA "HELLO" END 
SEND CHpib;UNL MLA TALK Device CMD 24+128 

Semantics 

CMD 

The expressions following a CMD are sent with ATN true. The ASCII 
characters representing the evaluated string expression are sent to the HP-IB. 
Numeric expressions are rounded to an integer MOD 256. The resulting byte is 
sent to the HP-IB. CMD with no items sets ATN true. 

DATA 

The expressions following DATA are sent with ATN false. The ASCII 
characters representing the evaluated string expression are sent. Numeric 
expressions are rounded to an integer MOD 256. The resulting byte is sent to 
the HP-IB. If END is added to the data list, EOI is set true before sending the 
last byte. DATA with no items sets ATN false without waiting to be addressed 
as a talker. 
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If the computer is active controller, and addressed as a talker, the data is 
sent immediately. If the computer is not active controller, it waits until it is 
addressed to talk before sending the data. 

TALK 

TALK sets ATN true and sends the specified talk address. Only one primary 
address is allowed for a single talker. An extended talker may be addressed by 
using SEC secondary address after TALK. A TALK address of 31 is equivalent 
to UNT (untalk). 

UNT 

UNT sets ATN true and sends the untalk command. (There is no automatic 
untalk.) A TALK address of 31 is equivalent to UNT. 

LISTEN 

LISTEN sets ATN true, sends one or more primary addresses, and addresses 
those devices to listen. A LISTEN address of 31 is equivalent to UNL 
(unlisten). 

UNL 

UNL set ATN true and sends the unlisten command. (There is no automatic 
unlisten.) A LISTEN address of 31 is equivalent to UNL. 

SEC 

SEC sets ATN true and sends one or more secondary addresses (commands). 

MTA 

MTA sets ATN true and sends the interface’s talk address. It is equivalent to 
performing a status sequence on the interface and then using the returned talk 
address with a SEND..TALK sequence. 
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MLA 

MLA sets ATN true and sends the interface’s listen address. It is equivalent 
to performing a status sequence on the interface and then using the returned 
listen address with a SEND..LISTEN sequence. 

Summary 

The computer must be the active controller to execute SEND with CMD, 
TALK, UNT, LISTEN, UNL, SEC, MTA and MLA. 

The computer does not have to be the active controller to send DATA. DATA 
is sent when the computer is addressed to talk. 

The following table lists the HP-IB message mnemonics, descriptions of the 
messages, and the secondary keywords required to send the messages. Any 
numeric values are decimal. 


HP-IB Messages Used With SEND 


Mnemonic 

Description 

Secondary Keyword and Value 

DAB 

Data Byte 

DATA 0 through DATA 255 

DCL 

Device Clear 

CMD 20 or CMD 148 

EOI 

End or Identify 

DATA (data) END (sends EOI with ATN false, 
which is the END message; EOI with ATN true is 
the Identify message, sent automatically with the 
PPOLL function) 

GET 

Group Execute 
Trigger 

CMD 8 or CMD 136 

GTL 

Go To Local 

CMD 1 or CMD 129 

IFC 

Interface Clear 

Not possible with SEND. An ABORT statement 
must be used. 

LAG 

Listen Address 
Group 

LISTEN 0 through LISTEN 31; or CMD 32 through 
CMD 63 
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HP-IB Messages Used With SEND (continued) 


Mnemonic 

Description 

Secondary Keyword and Value 

LLO 

Local Lockout 

CMD 17 

MLA 

My Listen Address 

MLA 

MTA 

My Talk Address 

MTA 

PPC 

Parallel Poll 
Configure 

CMD 5 or CMD 133 

PPD 

Parallel Poll 

Disable 

PPC (CMD 5 or CMD 133), followed by CMD 112; 
or CMD 240; or SEC 16. 

PPE 

Parallel Poll 

Enable 

PPC (CMD 5 or CMD 133), followed by CMD 96 
through CMD 111; or CMD 224 through CMD 239; 
or SEC 0 through SEC 15 (SEC 0 allows a mask to 
be specified by a numeric value) 

PPU 

Parallel Poll 
Unconfigure 

CMD 21 or CMD 149 

PPOLL 

Parallel Poll 

Not possible with SEND. PPOLL function must be 
used. 

REN 

Remote Enable 

Not possible with SEND. REMOTE statement must 
be used. 

SDC 

Selected Device 
Clear 

CMD 4 or CMD 132 

SPD 

Serial Poll Disable 

CMD 25 or CMD 153 

SPE 

Serial Poll Enable 

CMD 24 or CMD 152 

TAD 

Talk Address 

TALK 0 through TALK 31, or CMD 64 through 

CMD 95, or CMD 192 through CMD 223. 

TCT 

Take Control 

CMD 9 or CMD 137 

UNL 

Unlisten 

UNL, or LISTEN 31, or CMD 63, or CMD 191. 

UNT 

Untalk 

UNT, or TALK 31, or CMD 95, or CMD 223. 
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SEPARATE ALPHA FROM GRAPHICS 


SEPARATE ALPHA FROM GRAPHICS 


Supported On 
Option Required 
Keyboard Executable 
Programmable 


In an IF ... THEN ... 


UX WS DOS* 

GRAPH 

Yes 

Yes 

Yes 


This statement is used to simulate the separate alpha and graphics rasters 
of Series 200 displays (not valid in a windowing environment, such as X 
Windows). 


C 


SEPARATE ALPHA 


> 


Ifr^FROM GRAPHICS)-^ 


Example Statements 

SEPARATE ALPHA 

IF (S_300 AND Multi_plane) THEN SEPARATE ALPHA FROM GRAPHICS 

Semantics 

This statement is used to set up the planes on multi-plane bit-mapped alpha 
displays for independent use as separate alpha and graphics rasters. (This 
is the way that Series 200 displays work.) If the display is a monochrome, 
bit-mapped alpha display, an error will be reported. An error will also be 
reported if BASIC is running in a windowing environment. 
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The statement performs the following actions: 

1. PLOTTER IS CRT,“INTERNAL” is executed. 

2. If the display is bit-mapped alpha with more than one plane (not 
monochrome), then the following actions are taken: 

a. The screen is cleared. 

b. The alpha mask is set (see table below for details). 

c. The alpha pen is set (see table below for details). 

d. All appropriate color or gray map entries are initialized (see table below 
for details). 

e. The graphics mask is set so that it does not overlap with the alpha mask 
(the complement of the alpha mask). 

f. The alpha display is re-written in the new alpha color. 

Display-Specific Parameters 

Here are the values of parameters for the different types of Series 300 
bit-mapped alpha displays: 
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Number of 

Planes 

Alpha Mask 

Color Map 

Graphics Mask 

4 

Plane 4(1000 base 
2) Alpha pen is 8. 

Pens 0 through 7 have 
normal default values; pens 

8 through 15 are green. 

Planes 1 through 
3(0111 base 2) 
Graphics pens are 

0 through 7. 

6 

Planes 5 & 
6(110000 base 2) 
Alpha pens are 

16, 32, and 48. 

Pens 0 through 15 have 
normal default values; pens 

16 through 31 are green; 
pens 32 through 47 are 
brown; pens 48 through 63 
are cyan. 

Planes 1 through 
4(001111 base 2) 
Graphics pens are 

0 through 15. 

8 

Planes 7 & 
8(11000000 base 

2) Alpha pens are 
64, 128, and 192. 

Pens 0 through 63 have 
normal default values; pens 

64 through 127 are green; 
pens 128 through 191 are 
brown; pens 192 through 255 
are cyan. 

Planes 1 through 
6(00111111 base 2) 
Graphics pens are 

0 through 63. 

8 gray 

Planes 7 &; 8 
(11000000 base 2) 
Alpha pens are 

64, 128, and 192. 

Pens 0 through 63 have 
normal default values; 
pens 64 through 127 have 
lum=.30; pens 128 through 
191 have lum=.53; pens 192 
through 255 have lum=.41. 

Planes 1 through 
6(00111111 base 2) 
Graphics pens are 

0 through 63. 


If you are using a gray scale display, refer to the chapter “More About Color 
Graphics” in the HP BASIC 6.2 Advanced Programming Techniques manual for 
more information. 

Color map entries below the lowest alpha pen value have their default colors set 
by PLOTTER IS CRT,"INTERNAL". Using a value in this range as an alpha pen 
will produce transparent text (i.e., is equivalent to using pen 0). Setting up the 
color or gray map as given in the table causes the alpha text to be dominant 
over graphics images. If the COLOR MAP option is used with PLOTTER IS, 
the SET PEN statement can still be used to set all color or gray map entries, 
not just those dedicated to graphics pens. 
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Here is a BASIC program that performs similar configuration of the planes of a 
4-plane display: 

100 PLOTTER IS CRT, "INTERNAL";COLOR MAP ISeries 300 display 
110 FOR 1=8 TO 15 

120 SET PEN I INTENSITY 0,1,0 ! Set alpha colors (green). 

130 NEXT I 

140 ALPHA PEN 0 ! Set alpha pen to black (temp). 

150 ALPHA MASK 15 I Enable all planes (temp). 

160 CLEAR SCREEN 

170 ALPHA MASK 8 ! Enable plane 4 for alpha. 

180 ALPHA PEN 8 I Set alpha pen. 

190 INTEGER Gm(0) I Declare array for GESCAPE. 

200 Gm(0)=7 I Set bits 2,1,0, which select 
210 GESCAPE CRT,7,Gm(*) I graphics planes 3,2,1. 

220 ALPHA ON I Display alpha plane. 

230 GRAPHICS ON I Display graphics planes. 

240 PLOTTER IS CRT,"INTERNAL" I Return to non-color-map 
250 END I mode. 

Note that when using this operation with AREA COLOR and AREA 
INTENSITY, there may be unexpected results. The algorithm that AREA 
COLOR and AREA INTENSITY use to select graphics pens does not account 
for the graphics write-enable or display-enable masks. If the pens selected by 
these statements have bits outside of the write-enable mask, then the planes 
corresponding to these bits will not be affected. The result is that the area fill 
colors will not be what is expected. 


BASIC/UX Specifics 

Does not work in a windowed environment. 


BASIC/DOS Specifics 

Supported only for VGA (color or monochrome) and EGA displays. 
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SET ALPHA MASK 


Supported on 
Option Required 
Keyboard Executable 
Programmable 


In an IF ... THEN ... 


UX WS DOS 

CRTX 

Yes 

Yes 

Yes 


This statement is used to specify which plane(s) can be modified by alpha 
display operations. 


Q 


SET ALPHA MASK 




frame 

buffer mosk 


Item 

Description/Default 

Range Restrictions 

frame buffer 

numeric expression, rounded to an 

1 through 2~n — 1, where n 

mask 

integer 

equals the number of display 



planes 


Example Statements 

SET ALPHA MASK Frame_mask 

SET ALPHA MASK 3 

SET ALPHA MASK IVAL("1100",2) 

IF Total.frames = 5 THEN SET ALPHA MASK 8 

Semantics 

This statement does not affect the operation of monochrome displays or the 
display of the Model 236C. An error is reported if BASIC is running in a 
windowing environment. 

Setting bit 0 of the frame buffer mask (i.e. SET ALPHA MASK 1) enables 
alpha write permission to plane 1; setting bits 2 and 3 of the frame buffer mask 
(i.e. SET ALPHA MASK 12) enables write permission to planes 3 and 4. The 
masks you can use to enable write permissions range from 1 through n — 1 
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where n is the number of display planes (e.g. the range of frame buffer masks 
for 4-planes would be 1 through 15). 

This statement affects any alpha display operation using the CRT (e.g. PRINT, 
DISP, CAT, error messages, etc.). 

The difference between this statement and SET DISPLAY MASK is SET 
ALPHA MASK specifies which plane(s) can be modified by alpha operations 
(regardless of whether or not it/they are displayed). SET DISPLAY MASK 
specifies the plane(s) that are to be displayed (regardless of whether or not 
anything has been or can be written to it/them). 

For further information on the alpha write-enable mask, see the HP BASIC 6.2 
Programming Guide. 

Note that the functionality of this statement can be achieved through CRT 
CONTROL register 18. 

For more information related to this statement, see SEPARATE ALPHA and 
MERGE ALPHA which are found in this reference. 
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SET CHR 


Supported On 
Option Required 
Keyboard Executable 
Programmable 


In an IF... THEN... 


UX WS DOS’" 

CRTX 

Yes 

Yes 

Yes 


This statement re-defines the bit-pattern used for character(s) in the current 
font (on bit-mapped alpha/graphics displays only). 


(set cHR> H^L r hO-' 


Item 

Description 

Range 

first character 

numeric expression, rounded to an 
integer, which specifies the numeric 
code of the first character to be 
re-defined 

0 through 258 

bit-pattern 

array 

name of an INTEGER array 

any valid name 


Example Statements 

ALLOCATE INTEGER Char.cell(1:CHRY,1:CHRX) 

SET CHR Char_code,Char_cell(*) 

ALLOCATE INTEGER Entire_font(l:Num_chars,l:CHRY,l:CHRX) 
SET CHR 0,Entire_font(*) 


SAVE - SYSTEMS S-31 




SET CHR 


Semantics 

If the alpha display is not bit-mapped (that is, if the alpha is separate from the 
graphics raster, and is generated by character-generator-ROM hardware), then 
attempting to execute this statement results in error 880. 

The “first character” parameter specifies the code of the first character whose 
bit-pattern is to be re-defined. 

The “bit-pattern array” contains the actual pixels that are to comprise the new 
character. If the display is monochrome (single-plane), then only the low-order 
bit of each INTEGER element is used. If the display is color (multi-plane), 
then as many bits are used as there are planes in the display. 

If the bit-pattern array parameter has only two dimensions, then only one 
character is re-defined. The first dimension must have a range of exactly 
the value of CHRY for this display; the second must have a range of CHRX. 
(Character cells are 20 rows by 10 columns for 1280 X 1024 resolution 
bit-mapped alpha displays, 16 rows by 8 columns for 1024 x 768 resolution 
bit-mapped alpha displays, and 15 rows by 12 columns for medium-resolution 
bit-mapped alpha displays.) 

If the bit-pattern array parameter has three dimensions, then multiple 
characters are re-defined beginning at the character specified by the “first 
character” parameter, and continuing until the array is exhausted (or character 
code 256 is reached, whichever occurs first). The first dimension of this array 
corresponds to the character’s code, the second to the character-cell row, and 
the third to the character-cell column. 

Underline Character Definition 

Note that character code 256 is the pattern which is exclusive OR’d with a 
one-byte character to produce underlined characters on the display. 

For two-byte characters, BASIC uses the character codes 257 and 258 to 
exclusive OR with the first and second bytes, respectively. 

For information regarding enabling underlining on the CRT, see the section, 
“Display-Enhancement Characters”, in the “Useful Tables” section of this 
manual. 
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Restoring the Power-Up Default Font 

If you want to return to using the default font, then execute this statement: 
CONTROL CRT,21;1 

BASIC/DOS Specifics 

All bits on the bit pattern for a character must be the same color. Restoring 
the power-up default font is not supported. 


S 
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Supported On 
Option Required 
Keyboard Executable 
Programmable 


In an IF ... THEN ... 


UX WS DOS 

CRTX 

Yes 

Yes 

Yes 


This statement is used to specify which plane(s) can be seen on the alpha 
display. 


(set display mask >1 


frome 

buffer mask 


Item 

Description/Default 

Range Restrictions 

frame buffer 

numeric expression, rounded to an 

0 through 2"n — 1, where n 

mask 

integer 

equals the number of display 



planes 


Example Statements 

SET DISPLAY MASK Frame.mask 

SET DISPLAY MASK 3 

SET DISPLAY MASK IVAL(”1100",2) 

IF Disp.frames = 5 THEN SET DISPLAY MASK 8 

Semantics 

This statement does not affect the operation of monochrome displays or the 
display of the Model 236C. An error is reported if BASIC is running in a 
windowing environment. 

Setting bit 0 of the frame buffer mask (i.e. SET DISPLAY MASK 1) enables 
the displaying of alpha plane 1; setting bits 2 and 3 of the frame buffer mask 
(i.e. SET DISPLAY MASK 12) enables displaying of alpha planes 3 and 4. 
The masks you can use to enable display range from 0 through 2~n — 1 where 
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n is the number of display planes (e.g. the range of frame buffer masks for 
4-planes would be 0 thru 15). 

This statement affects any display operation using the CRT (e.g. PRINT, DISP, 
CAT, error messages, graphics, etc.). 

The difference between this statement and SET ALPHA MASK is SET 
DISPLAY MASK specifies the plane(s) that are to be displayed (regardless of 
whether or not anything has been or can be written to it/them). SET ALPHA 
MASK specifies which plane(s) can be modified by alpha operations (regardless 
of whether or not it/they are displayed). 

For further information on the display-enable mask, see the HP BASIC 6.2 
Programming Guide. 

Note that the functionality of this statement can be achieved through CRT 
CONTROL register 20. 

For more information related to this statement, see ALPHA ON/OFF, 
GRAPHICS ON/OFF, and GESCAPE found in this reference. 
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Supported On 
Option Required 
Keyboard Executable 
Programmable 


In an IF ... THEN ... 


UX WS DOS 

GRAPHX 

Yes 

Yes 

Yes 


This statement sets an echo to the specified location on the current PLOTTER 
IS device. 


(set echo) — 


x coordinate 


KH coordinate |h►{ 


Item 

Description 

Range 

x coordinate 

numeric expression in current units 

— 

y coordinate 

numeric expression in current units 

— 


Example Statements 

SET ECHO Xin,Yin 
SET ECHO 1000,10000 

Semantics 

If the current PLOTTER IS device is a CRT, a 9-by-9-dot cross-hair is 
displayed at the specified coordinates if they are within the hard clip limits; the 
soft clip limits are ignored. No echo is displayed if the coordinates are outside 
the hard clip limits. 

If the current PLOTTER IS device is an HPGL plotter, the pen is raised and 
moved to the specified coordinates if they are within the current clip limits. 

If the pen is inside the clip limits and the new echo position is not, it moves 
towards the new echo position but stops at the clip boundary. If the pen is 
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outside the clip limits and the new echo position is outside the clip limits, the 
pen moves along the nearest clip boundary. 

SET ECHO is frequently used with the READ LOCATOR statement. 
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Supported On UX WS* 

Option Required n/a 

Keyboard executable Yes 

Programmable Yes 

In an IF ... THEN ... Yes 


This statement enables the specified HIL devices for use by the BASIC system. 


( SET HIL MASK 


address mask 


Item 

Description 

Range 

address mask 

the sum of 2 raised to the power of 

any even number from 0 to 


each of the addresses of the desired 

254 


devices 



Example Statements 

SET HIL MASK 16 

SET HIL MASK 2“Mouse+2“Knobboxl+2“Buttonbox2 


Semantics 

The address mask provides the capability of specifying the HIL devices to be 
used by the BASIC system. The most recent SET HIL MASK statement 
specifies the HIL devices which are used in subsequent ON KNOB, ON CDIAL, 
ON HIL EXT, and GRAPHICS INPUT IS statements. In addition, it specifies 
the devices which generate arrow keystrokes during live keyboard and editing 
when the devices are not being used by any of the above statements. 

The value of the mask is obtained by raising 2 to the power of each of the 
addresses of the desired device, and adding these values. Suppose you want 
to create a mask which would only allow interrupts from HP-HIL devices at 
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addresses 1 and 3. You would take 2 and raise if to the first power and add 
this result to 2 raised to the third power; the final result is a mask value of 10. 

At start-up time, the BASIC system attempts to use all available devices on 
the HP-HIL link. You may then use this statement to select only those devices 
which you require and relinquish the other devices for use by different HP-UX 
processes (e.g. other BASIC/UX processes). You should never specify the 
address of the HIL keyboard with this statement since this interferes with the 
operation of BASIC and block all keyboard input. 

Any HIL device which has been specified with this statement or which is not 
owned by other processes can be identified using the HIL SEND statement as 
in: 


HIL SEND 4; IDD 

You should note that the X Windows environment monopolizes all HIL devices 
unless explicitly specified not to do so. When a device is thus owned by X 
Windows, it is not available for use by any BASIC processes running under the 
environment. 

Each invocation of rmb in the X Windows environment should relinquish the 
HP HIL devices that it does not need with SET HIL MASK to allow other 
invocations of rmb to access those devices; otherwise, the first invocation of rmb 
will monopolize all HP HIL devices on the link. 
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Supported On 
Option Required 
Keyboard Executable 
Programmable 


In an IF ... THEN ... 


UX WS DOS 

KBD 

Yes 

Yes 

Yes 


This statement programmatically re-defines typing-aid softkey(s). 


(set KPr> q,JXrN 7 )- T -*f 


string containing 1 
typing-aid definition 


s> 


string array of 
softkey definition(s) 




Item 

Description 

Range 

key number 

numeric expression, rounded to an 
integer 

0 through 23 

string 

containing 

1 softkey 
definition 

string expression 

any valid string expression 

string array 
of softkey 
definition(s) 

name of a string array 

any valid name 


Example Statements 

SET KEY 1,0neKey$ 

SET KEY First_key,Several_keys$(*) 
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Typing-aid softkeys are used when typing text at the keyboard. They are 
active whenever there is not a running program that has defined interrupt 
service routines for the keys (with ON KEY). 

The “first key” parameter indicates the first key to be re-defined. 

The second parameter (the string expression or array) determines the number 
of keys to be re-defined: 

■ If the parameter is a string expression (which includes a simple string 
variable), then only one typing-aid softkey is re-defined. 

■ If the parameter is a string array, then several typing-aid softkeys may be 
re-defined. Softkeys are re-defined in ascending order, one for each array 
element, until one of the following conditions is true: 

□ the end of the array is reached 

□ the last softkey is re-defined 

□ typing-aid softkey memory overflows 

For instance, if this parameter has a value of 5, and the string array has 3 
elements, then softkeys (fs), (ftp, and (77) are redefined, respectively. 

In order to minimize the chances of typing-aid memory overflows, keys in 
the range to be re-defined are first cleared and then the corresponding string 
values are placed into typing-aid memory. For instance, if the “first key” 
parameter is 3 and the array contains 4 elements, then softkeys 3 through 6 are 
cleared, after which the string array elements are placed into the corresponding 
softkeys. If typing-aid memory does overflow, the remaining keys in the range 
remain undefined. For instance, in this example if a memory overflow occurred 
while defining key 5, then keys 3 and 4 would have new definitions while keys 5 
and 6 would remain undefined. 

If the string, or string array element, contains a null (0 length) string, the 
corresponding typing-aid becomes undefined. Use EDIT KEY or LOAD KEY 
to define null string typing-aids. 
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Supported On 
Option Required 
Keyboard Executable 
Programmable 


In an IF.. THEN ... 


UX WS DOS 

GRAPHX 

Yes 

Yes 

Yes 


This statement specifies a new position for the locator of the current graphics 
input device. 


SET LOCATOR 


>r 


x coordinote 


KH 


coordinote M 


Item 

Description 

Range 

x coordinate 

numeric expression specifying the 
x coordinate of the locator’s new 
position in current units 

range of REAL 

y coordinate 

numeric expression specifying the 
y coordinate of the locator’s new 
position in current units 

range of REAL 


Example Statements 

SET LOCATOR 12,95 
SET LOCATOR X_cor,Y_cor 


Semantics 

If any of the coordinates are outside the device’s limits, they are truncated to 
the nearest boundary. 

In order to change the X and Y coordinates of the locator, the graphics input 
device must have a programmable locator position, (e.g. graphics input is from 
the keyboard and other relative locators). 
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The HP 9111A tablet does not support this capability. 


S 
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SET PEN 


Supported on 
Option Required 
Keyboard Executable 
Programmable 
In an IF ... THEN 


UX WS DOS 

GRAPHX 

Yes 

Yes 

Yes 


This statement defines the color or gray value for one or more entries in the 
color map. 



Item 

Description 

Range 

pen selector 

numeric expression, rounded to an 
integer 

0 through 32 767 

hue 

numeric expression 

0 through 1 

saturation 

numeric expression 

0 through 1 

luminosity 

numeric expression 

0 through 1 

HSL array 

name of a two-dimensional, 

any valid name 

name 

three-column REAL array 


red 

numeric expression 

0 through 1 

green 

numeric expression 

0 through 1 

blue 

numeric expression 

0 through 1 

RGB array 

name of a two-dimensional, 

any valid name 

name 

three-column REAL array 
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Note The colors defined with SET PEN become active only after a 

PLOTTER IS-COLOR MAP statement, such as: 

PLOTTER IS CRT, "INTERNAL"; COLOR MAP 


Example Statements 

SET PEN 3 COLOR Hue,Saturation,Luminosity 
SET PEN Pen_number INTENSITY Color_map_array(*) 

SET PEN 0 INTENSITY 4/15,4/15,4/15 

Semantics 

This statement defines the color or gray value for one or more entries in the 
color map. Either the HSL (hue/saturation/luminosity) color model or the 
RGB (red/green/blue) color model may be used. This statement is ignored for 
non-color mapped devices and color or gray mapped devices in non-color map S 

mode. 

For both SET PEN COLOR and SET PEN INTENSITY, the pen selector 
specifies the first color or gray map entry to be defined. If individual RGB 
or HSL values are given, that entry in the color or gray map is the only one 
defined. If an array is specified, the color or gray map is redefined, starting at 
the specified pen, and continuing until either the highest-numbered entry in the 
map is redefined or the source array is exhausted. 

Specifying color or gray with the SET PEN and AREA PEN statements 
(resulting in non-dithered color) results in a much more accurate representation 
of the desired color than specifying the color with an AREA statement. 

SET PEN COLOR 

The hue value specifies the color. The hue ranges from zero to one, in a 
circular manner, with a value of zero resulting in the same hue as a value of 
one. The hue, as it goes from zero to one, proceeds through red, orange, yellow, 
green, cyan, blue, magenta, and back to red. 

The saturation value, classically defined, is the inverse of the amount of white 
added to a hue. What this means is that saturation specifies the amount of hue 
to be mixed with white. As saturation goes from zero to one, there is 0% to 


SAVE - SYSTEMS S-45 



SET PEN 


100% of pure hue added to white. Thus, a saturation of zero results in a gray, 
dependent only upon the luminosity; hue makes no difference. 

The luminosity value specifies the brightness per unit area of the color. A 
luminosity of zero results in black, regardless of hue or saturation; if there is no 
color, it makes no difference which color it is that is not there. 

If you are using a gray scale display, hue and saturation are not used, and 
the brightness per unit area of gray is specified by the luminosity value. A 
luminosity of zero results in black. 

The example program COLORS, found on the MANUAL EXAMPLES disk, 
demonstrates many of the effects of HSL color model. 

COLORS shows the changes brought about by varying one HSL parameter at a 
time. The button bar shows that when saturation (the amount of color) is zero, 
hue makes no difference, and varying luminosity results in a gray scale. 

It also displays the fully saturated, fully luminous colors selected as the hue 
value goes from 0 through 1. Any value between zero and one, inclusive, can 
be chosen to select color, but the resolution (the amount the value can change 
before the color on the screen changes) depends on the value of hue, as well as 
the other two parameters. 

COLORS illustrates the effect that varying saturation and luminosity has on hue 
with several small color wheels. 

SET PEN INTENSITY 

The red, green, and blue values specify the intensities of the red, green, and 
blue colors displayed on the screen. 

If you are using a gray scale display, the luminosity value specifies the intensity 
of gray. 

The example program COLORS, found on the MANUAL EXAMPLES disk, 
demonstrates the effect of varying the intensity of one color component while 
the other two remain constant. 

It also shows combinations of red, green and blue. The values are represented 
in fifteenths: 0 fifteenths, 5 fifteenths, 10 fifteenths, and 15 fifteenths—every 
fifth value. Fifteenths are the units. Thus, zero fifteenths through fifteen 
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fifteenths made a total of sixteen levels. The values for each color component 
are represented in that color. 

BASIC/UX Specifics 

Dithering on the HP 2397 terminal assumes that the hardware color map 
contains power-on color assignments. However, these do not correspond to the 
standard BASIC color map. To make dithering results accurate on the HP 
2397, the color map must be set to the following with SET PEN: 


Pen 

R 

G 

B 

0 

0.0 

0.0 

0.0 

1 

1.0 

0.0 

0.0 

2 

0.0 

1.0 

0.0 

3 

1.0 

1.0 

0.0 

4 

0.0 

0.0 

1.0 

5 

1.0 

0.0 

1.0 

6 

0.0 

1.0 

1.0 

7 

1.0 

1.0 

1.0 


S 


BASIC/DOS Specifics 

SET PEN color selections are fully supported for a VGA color display. 
However, for an EGA display, the color selections are limited. 


SAVE-SYSTEMS S-47 




SET TIME 


Supported On 
Option Required 
Keyboard Executable 
Programmable 


In an IF ... THEN ... 


UX WS DOS 

None 

Yes 

Yes 

Yes 


This statement resets the time-of-day given by the real-time clock. 



Item 

Description 

Range 

seconds 

numeric expression, rounded to the 
nearest hundredth 

0 through 86 399.99 


Example Statements 

SET TIME 0 

SET TIME Hours*3600+Minutes*60 
SET TIME TIME("8:37:30 M ) 

SET TIME (BASIC/UX only) 

Semantics 

SET TIME changes only the time within the current day, not the date. The 
new clock setting is equivalent to (TIMEDATE DIV 86 400) X 86 400 plus the 
specified setting. 
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BASIC/UX Specifics 

This statement does not reset the HP-UX clock, even if the user is super-user. 
Instead it resets the clock which BASIC/UX keeps for itself. 

SET TIME without a parameter resynchronizes the time with the HP-UX 
clock. This does not affect the date nor the timezone. If the timezone is 
subsequently resynchronized with HP-UX (via TIMEZONE IS), then the time 
will change accordingly. The proper way to resynchronize both the time and 
timezone is to do the timezone first as in: 

TIMEZONE IS 
SET TIME 

BASIC/DOS Specifics 

With MS-DOS 3.1 and 3.2, SET TIME affects only the “local” BASIC time 
and MS-DOS time. With MS-DOS 3.3 and above, SET TIME also sets the 
CMOS battery-backed clock (the real time clock on the PC). 
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SET TIMEDATE 


Supported On 
Option Required 
Keyboard Executable 
Programmable 


In an IF ... THEN ... 


UX WS DOS 

None 

Yes 

Yes 

Yes 


This statement resets the absolute seconds (time and day) given by the 
real-time clock. 


C 


SET TIMEDATE 


> 


I BASIC/UX | 

I only l 

L|- 1- -3»L 

seconds ^ 


Item 

Description 

Range 

seconds 

numeric expression, rounded to 

2.086 629 12 E+ll through 


the nearest hundredth 

2.143 252 223 999 9 E+ll 


Example Statements 

SET TIMEDATE TIMEDATE+3600 
SET TIMEDATE Strange_number 

SET TIMEDATE DATEO'l Jan 1989") + TIME("13:57:20") 

SET TIMEDATE (BASIC/UX only) 

Semantics 

The volatile clock is set to 2.086 629 12 E+ll (midnight March 1, 1900) 
at power-on (BASIC Workstation semantics). If there is a battery-backed 
(non-volatile) clock, then the volatile clock is synchronized with it at power-up. 
If the computer is on an SRM system (and has no battery-backed clock), then 
the volatile clock is synchronized with the SRM clock when the SRM and 
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SET TIMEDATE 


DCOMM binaries are loaded. The clock values represent Julian time, expressed 
in seconds. 

BASIC/UX Specifics 

The volatile clock is set to the current HP-UX time at power-on. The clock 
values represent Julian time, expressed in seconds. 

Note that this statement does NOT reset the HP-UX clock, even if the user is 
super-user. Instead it resets the clock which BASIC keeps for itself. 

SET TIMEDATE without a parameter resynchronizes the time and date 
with the HP-UX clock. This does not affect the timezone. If the timezone is 
subsequently resynchronized with HP-UX (via TIMEZONE IS), then the time 
and date will change accordingly. The proper way to resynchronize the time, 
date, and timezone is to do the timezone first as in: 

TIMEZONE IS 
SET TIMEDATE 

BASIC/DOS Specifics 

With MS-DOS 3.1 and 3.2, SET TIMEDATE affects only the “local” BASIC 
time and MS-DOS time. With MS-DOS 3.3 and above, SET TIMEDATE also 
sets the CMOS battery-backed clock (the real time clock on the PC). 


SAVE - SYSTEM$ S-51 



SGN 


Supported On 
Option Required 
Keyboard Executable 
Programmable 


In an IF ... THEN ... 


UX WS DOS IN 

None 

Yes 

Yes 

Yes 


This function returns 1 if the argument is positive, 0 if it equals zero, and —1 if 
it is negative. 


K>> 


Example Statements 

Root=SGN(X)*SQR(ABS(X)) 

Z=2*PI*SGN(Y) 

Semantics 

COMPLEX arguments are not allowed with this function. 
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SHIFT 


Supported On 
Option Required 
Keyboard Executable 
Programmable 
In an IF... THEN... 


UX WS DOS IN 

None 

Yes 

Yes 

Yes 


This function returns an integer which equals the value obtained by shifting the 
16-bit binary representation of the argument by the number of bit positions 
specified, without wrap-around. 


KSH 


bit position 
displacement 


K>> 


Item 

Description 

Range 

argument 

numeric expression, rounded to an 
integer 

-32 768 through +32 767 

bit position 

numeric expression, rounded to an 

— 15 through +15 

displacement 

integer 



Example Statements 

New_word=SHIFT(01d_word, -2 ) 

Mask=SHIFT(l.Position) 

Semantics 

If the bit position displacement is positive, the shift is towards the 
least-significant bit. If the bit position displacement is negative, the shift is 
towards the most-significant bit. Bits shifted out are lost. Bits shifted in are 
zeros. The SHIFT operation is performed without changing the value of any 
variable in the argument. 
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SHIFT IN ... OUT 

See the ASSIGN, DUMP DEVICE IS, PRINTALL IS, and PRINTER IS 
statements. 
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SHOW 


Supported On 
Option Required 
Keyboard Executable 
Programmable 


In an IF... THEN... 


UX WS DOS 

GRAPH 

Yes 

Yes 

Yes 


This statement is used to define an isotropic current unit-of-measure for 
graphics operations. 



Item 

Description 

Range 

left 

numeric expression 

— 

right 

numeric expression 

^ left 

bottom 

numeric expression 

— 

top 

numeric expression 

bottom 


Example Statements 

SHOW -5,5,0,100 

SHOW Left.Right.Bottom,Top 


Semantics 

?HOW defines the values which must be displayed within the hard clip 
boundaries, or the boundaries defined by the VIEWPORT statement. SHOW 
:reates isotropic units (units the same in X and Y). The direction of an axis 
nay be reversed by specifying the left greater than the right or the bottom 
greater than the top. (Also see WINDOW.) 
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For information on scaling with large ranges, when using the SHOW statement, 
read the section “Special Considerations about Scaling” in the chapter “Using 
Graphics Effectively” found in the HP BASIC 6.2 Programming Guide. 
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SIGNAL 


Supported On 
Option Required 
Keyboard Executable 
Programmable 


In an IF ... THEN ... 


UX WS DOS 
10 
Yes 
Yes 
Yes 


This statement generates a software interrupt. 


( SIGNAL 


signal 

selector 


Item 

Description 

Range 

signal selector 

numeric expression, rounded to an 
integer 

0 through 15 


Example Statements 

SIGNAL 3 
SIGNAL Bailout 


Semantics 

[f an ON SIGNAL statement for the specified signal selector exists, and all 
the other conditions for an event-initiated branch are fulfilled, the branch 
defined in the ON SIGNAL statement is taken. If no ON SIGNAL exists for 
the specified signal selector, the SIGNAL statement causes no action. 
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SIN 


Supported On 
Option Required 
Keyboard Executable 
Programmable 


In an IF ... THEN ... 


UX WS DOS IN 

None 

Yes 

Yes 

Yes 


This function returns the sine of the angle represented by the argument. 





Range 

Item 

Description 

Restrictions 

argument 

numeric expression in current units of 

absolute values less than: 


angle when arguments are INTEGER 

1.708 312 781 2 E+10 deg 


or REAL 

or 2.981 568 26 E+8 rad 


numeric expression in radians when 
argument is COMPLEX 

; see “Range Restriction 
Specifics” for COMPLEX 
arguments 


Examples Statements 

Sine=SIN(Angle) 

PRINT "Sine of ";Theta;;SIN(Theta) 

Semantics 

If the argument is REAL or INTEGER, the value returned is REAL. If the 
argument is COMPLEX, the value returned is COMPLEX. 

To compute the SIN of a COMPLEX value, the COMPLEX binary must be 
loaded. 
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Range Restriction Specifics 

The formula used for computing the SIN of a COMPLEX argument is: 

CMPLX(SIN(Real_part)*C0SH(Imag.part),COS(Real_part)*SINH(Imag_part)) 

where Real^part is the real part of the COMPLEX argument and Imag.part 
is the imaginary part of the COMPLEX argument. Some values of a 
COMPLEX argument may cause errors in this computation. For example, 

SIN(CMPLX(0.MAXREAL)) 

will cause error 22 due to the COSH(Imag_part) calculation. 

Note that any COMPLEX function whose definition includes a sine or cosine 
function will be evaluated in the radian mode regardless of the current angle 
mode (i.e. RAD or DEG). 


S 
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SINH 


Supported On 
Option Required 
Keyboard Executable 
Programmable 


In an IF ... THEN ... 


UX WS DOS 

COMPLEX 

Yes 

Yes 

Yes 


This function returns the hyperbolic sine of a numeric expression. 



Item 

Description/Default 

Range 

Restrictions 

argument 

numeric expression 

—710 through 710 for 
INTEGER or REAL 
arguments; see “Range 
Restriction Specifics” for 
COMPLEX arguments 


Example Statements 

Result=SINH(-8.2475) 

PRINT "Hyperbolic Sine = SINH(Expression) 


Semantics 

If an INTEGER or REAL argument is given, this function returns a REAL 
value. If a COMPLEX argument is given, this function returns a COMPLEX 
value. 
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Range Restriction Specifics 

The formula used for computing SINH is as follows: 

(EXP(Argument) - EXP(-Argument))/2 

where Argument is the argument of the SINH function. Some arguments may 
cause errors in intermediate values computed during this computation. For 
example, 

SINH(KAXREAL) 

will cause error 22 due to the EXP (Argument) computation. 


S 
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SIZE 


Supported On 
Option Required 
Keyboard Executable 
Programmable 


In an IF ... THEN ... 


UX WS DOS IN 

MAT 

Yes 

Yes 

Yes 


This function returns the size (number of elements) of a dimension of an array. 
This INTEGER value represents the difference between the upper bound and 
the lower bound, plus 1. 



*o* dimension VO-*- 


Item 

Description 

Range 

array name 

name of an array 

any valid name 

dimension 

numeric expression, rounded to an 

1 through 6; < the RANK of 


integer 

the array 


Example Statements 

Upperbound(2)=BASE(A,2)+SIZE(A,2)-1 
Number_words-SIZE(Words$,1) 
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SORT 

See the MAT SORT statement. 


SAVE - SYSTEMS S-63 


SOUND 


Supported On UX WS 

Option Required KBD 

Keyboard Executable Yes 

Programmable Yes 

In an IF ... THEN ... Yes 


This statement produces a single tone or multiple tones on the sound generator 
of an HP-HIL interface. 



Item 

Description 

Range 

voice number 

numeric expression, rounded to an 
integer 

1 through 3 

frequency 

numeric expression, rounded to an 
integer 

83 through 83 333 Hz (see 
following table) 

volume 

numeric expression, rounded to an 
integer 

0 through 15 

duration 

numeric expression, rounded to an 
integer 

0, 0.01 through 2.55 

array of sound 
instructions 

INTEGER array 

must contain the proper 
number of non-zero values 
(see Semantics) 
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Example Statements 

SOUND Voice_num,Freq,Volume,Duration 
SOUND 1,440,12,0.50 
SOUND Instructions(*) 


Semantics 

If the multiple-parameter syntax is used, then the SOUND statement generates 
one tone on the specified voice number; the frequency, volume, and duration of 
the tone are as specified by the last three parameters of the statement. Note 
that the BASIC system does not wait for the tone to finish before executing 
the following program line or statement (if any). If you want to generate 
a sequence of tones, you must either generate a delay between SOUND 
statements (such as with WAIT), or use the SOUND syntax described below. 

If the single-parameter syntax is used (that is, a numeric array is specified), 
then the elements of the array are read sequentially and interpreted according 
to the following rules: 
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Instruction 

Sound Chip Effect Produced 

0 

Exit the SOUND statement (and stop reading array elements) 

1 to 3 

The specified voice is to be used; also says to read the next three array 
elements, and interpret them as follows, respectively: 

■ tone number—used to set the frequency (frequency = 83 333 / tone 
number). 

■ volume—0 = off; 1 through 15 are lowest to highest volume. 

■ duration—values 0 through 255 are interpreted as follows: 

0 is interpreted as “sound indefinitely”. 

1 through 255 are interpreted as 10’s of milliseconds (i.e., 1/100 
second); 

4 

Specifies that the noise voice is to be used; also says to read the next 
three array elements and interpret them as above (the same as with 
voice numbers 1 to 3), except that the tone number parameter is 
interpreted as follows: 

0 => periodic noise; fast shift register clock; 1 => periodic noise; 
medium shift register clock; 2 => periodic noise; slow shift register 
clock; 3 => periodic noise; clock shift register with voice 3; 

4 => white noise; fast shift register clock; 5 => white noise; medium 
shift register clock; 6 => white noise; slow shift register clock; 7 => 
white noise; clock shift register with voice 3. 

5 to 8 

Wait for voice 1 to 4, respectively, to finish sounding before executing 
the next sound instruction (if any). 

9 

Read the following array element, and wait the specified interval 
(100 microseconds x that element’s value) before executing the next 
instruction (if any). 



If the end of the array is reached on one of these boundaries, then the SOUND 
statement terminates normally; however, if the last element of the array has 
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SOUND 


been reached and the BASIC system expects to read more values, then error 17 
will be reported (subscript out of range). 

Producing Notes in the Equal-Tempered Scale 

Here is a list of the notes in the equal-tempered musical scale. The table shows 
that the frequencies available with the SOUND statement are close to the 
even-tempered notes, but are not exact. The equal-tempered scale is derived 
from the following relationship: 

frequency of note = 2U/ 12 ) x (frequency of preceding note) 


Note 

Ideal 

Frequency 

Tone 

Number 

Closest 

Frequency 

E 

82.41 

1011 

82.43 

F 

87.31 

954 

87.35 

F# 

92.50 

901 

92.49 

G 

98.00 

850 

98.04 

G# 

103.83 

803 

103.78 

A 

110.00 

758 

109.94 

A# 

116.54 

715 

116.55 

B 

123.47 

675 

123.46 

C 

130.81 

637 

130.82 

c# 

138.59 

601 

138.66 

D 

146.83 

568 

146.71 

D# 

155.56 

536 

155.47 

E 

164.81 

506 

164.69 

F 

174.61 

477 

174.70 

F# 

185.00 

450 

185.18 

G 

196.00 

425 

196.08 

G# 

207.65 

401 

207.81 

A 

220.00 

379 

219.88 

A# 

233.08 

358 

232.77 

B 

246.94 

337 

247.28 
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Note 

Ideal 

Frequency 

Tone 

Number 

Closest 

Frequency 

C 

261.63 

319 

261.23 

c# 

277.18 

301 

276.85 

D 

293.66 

284 

293.43 

D# 

311.13 

268 

310.94 

E 

329.63 

253 

329.38 

F 

349.23 

239 

348.67 

F# 

369.99 

225 

370.37 

G 

392.00 

213 

391.23 

G# 

415.30 

201 

414.59 

A 

440.00 

189 

440.92 

A# 

466.16 

179 

465.55 

B 

493.88 

169 

493.09 

C 

523.25 

159 

524.11 

c# 

554.37 

150 

555.55 

D 

587.33 

142 

586.85 

D# 

622.25 

134 

621.89 

E 

659.26 

126 

661.37 

F 

698.46 

119 

700.28 

F# 

739.99 

113 

737.46 

G 

783.99 

106 

786.16 

G# 

830.61 

100 

833.33 

A 

880.00 

95 

877.19 

A# 

932.33 

89 

936.33 

B 

987.77 

84 

992.06 
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Note 

Ideal 

Frequency 

Tone 

Number 

Closest 

Frequency 

C 

1046.50 

80 

1041.66 

c# 

1108.73 

75 

1111.11 

D 

1174.66 

71 

1173.70 

D# 

1244.51 

67 

1243.78 

E 

1318.51 

63 

1322.75 

F 

1396.91 

60 

1388.88 

F# 

1479.98 

56 

1488.09 

G 

1567.98 

53 

1572.32 

G# 

1661.22 

50 

1666.66 

A 

1760.00 

47 

1773.04 

A# 

1864.66 

45 

1851.84 

B 

1975.53 

42 

1984.12 

C 

2093.00 

40 

2083.33 

c# 

2217.46 

38 

2192.97 

D 

2349.32 

35 

2380.94 

D# 

2489.02 

33 

2525.24 

E 

2637.02 

32 

2604.16 

F 

2793.83 

30 

2777.77 

F# 

2959.96 

28 

2976.18 

G 

3135.96 

27 

3086.41 

G# 

3322.44 

25 

3333.32 

A 

3520.00 

24 

3472.21 

A# 

3729.31 

22 

3787.86 

B 

3951.07 

21 

3968.24 
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Note 

Ideal 

Frequency 

Tone 

Number 

Closest 

Frequency 

C 

4186.01 

20 

4166.65 

C# 

4434.92 

19 

4385.95 

D 

4698.64 

18 

4629.61 

D# 

4978.03 

17 

4901.94 

E 

5274.04 

16 

5208.31 

F 

5587.65 

15 

5555.53 

F# 

5919.91 

14 

5952.36 

G 

6271.93 

13 

6410.23 

G# 

6644.88 

13 

6410.23 

A 

7040.00 

12 

6944.42 

A# 

7458.62 

11 

7575.73 

B 

7902.13 

11 

7575.73 

C 

8372.02 

10 

8333.30 

c# 

8869.84 

9 

9259.22 

D 

9397.27 

9 

9259.22 

D# 

9956.06 

8 

10416.63 

E 

10548.08 

8 

10416.63 

F 

11175.30 

7 

11904.71 

F# 

11839.82 

7 

11904.71 

G 

12543.85 

7 

11904.71 

G# 

13289.75 

6 

13888.83 
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SPANISH 

See the LEXICAL ORDER IS statement. 


SAVE-SYSTEMS S-71 


SPOLL 


Supported On 
Option Required 
Keyboard Executable 
Programmable 
In an IF ... THEN ... 


UX WS DOS IN 
10 
Yes 
Yes 
Yes 


This function returns an integer containing the serial poll response from the 
addressed device. 



I/O poth 
name 

h 


J 

L . r 

device 1 


IrG)-'- 


Item 

Description 

Range 

I/O path 

name name assigned to a device 

any valid name (see 

ASSIGN) 

device selector 

numeric expression, rounded to an 

must include a primary 


integer 

address (see Glossary) 


Example Statements 

Stat=SP0LL(707) 

IF SPOLL(CDevice) THEN Respond 

Semantics 

A SPOLL may be executed under the following conditions: 

■ the computer must be the active controller 

■ multiple listeners are not allowed 

■ one secondary address may be specified to get status from an extended talker 
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Refer to the documentation provided with the polled device for information 
concerning the device’s status byte. 


Summary of Bus Actions 


Interface Select 
Code Only 

Primary Address 
Specified 

Error 

ATN 

UNL 

MLA 

TAD 

SPE 

ATN 

Read data 

ATN 

SPD 

UNT 
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Supported On 
Option Required 
Keyboard Executable 
Programmable 


In an IF ... THEN ... 


UX WS DOS IN 

None 

Yes 

Yes 

Yes 


This function returns the square root of the argument. 




Summary of Bus Actions 

Range 

Item 

Description/Default 

Restrictions 

argument 

numeric expression 

any valid INTEGER or 

REAL value for INTEGER 
and REAL expressions; for 
COMPLEX arguments, the 
range restriction for ABS 
applies here. 


Examples Statements 

Amps=SQRT(Watts/Ohms) 

PRINT "Square root of ";X;"=";SQR(Z) 


Semantics 

If the argument is REAL or INTEGER, the value returned is REAL. If the 
argument is COMPLEX, the value returned is COMPLEX. 

To compute the SQR or SQRT of a COMPLEX value, the COMPLEX binary 
must be loaded. 
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STANDARD 

See the LEXICAL ORDER IS statement. 
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STATUS 


Supported on 
Option Required 
Keyboard Executable 
Programmable 


In an IF ... THEN ... 


UX WS DOS 

None 

Yes 

Yes 

Yes 


This statement returns the contents of interface or I/O path name status 
registers. 



Item 

Description 

Range 

I/O path name 

name assigned to a device, devices, 
mass storage file, buffer, or pipe 

any valid name (see 

ASSIGN) 

interface select 
code 

numeric expression, rounded to an 
integer 

1 through 40 

register number 

numeric expression, rounded to an 
integer; Default = 0 

interface dependent 

numeric name 

name of a numeric variable 

any valid name 
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Example Statements 

STATUS l;Xpos,Ypos 
STATUS QFile,5;Record 


Semantics 

The value of the beginning register number is copied into the first variable, the 
next register value into the second variable, and so on. The information is read 
until the variables in the list are exhausted; there is no wrap-around to the first 
register. An attempt to read a nonexistent register generates an error. 

The register meanings depend on the specified interface or on the resource to 
which the I/O path name is currently assigned. Register 0 of I/O path names 
can be interrogated with STATUS even if the I/O path name is currently 
invalid (i.e., unassigned to a resource). Note that the Status registers of an 
I/O path are different from the Status registers of an interface. All Status and 
Control registers are summarized in the “Interface Registers” section at the 
back of the book. 
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STEP 

See the FOR ... NEXT construct. 
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STOP 


Supported On 
Option Required 
Keyboard Executable 
Programmable 


In an IF ... THEN ... 


UX WS DOS IN 

None 

Yes 

Yes 

Yes 


This statement terminates execution of the program. 



Semantics 

Once a program is stopped, it cannot be resumed by CONTINUE. RUN must 
be executed to restart the program. PAUSE should be used if you intend to 
continue execution of the program. 

A program can have multiple STOP statements. Encountering an END 
statement or pressing the (stopI ( [shiftH Stop) on the ITF keyboards) key has 
the same effect as executing STOP. After a STOP, variables that existed in the 
main context are available from the keyboard. 
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Supported On 


Option Required 
Keyboard Executable 
Programmable 


In an IF ... THEN ... 


UX WS DOS IN* 

None 

Yes 

Yes 

Yes 


This statement creates a file and stores the program or typing-aid key 
definitions into it. 



literol form of file specifier: 



HP'S or SRM files only 


literal form of DFS file specifier: 
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Item 

Description 

Range 

file specifier 

string expression 

(see drawing) 

directory path 

literal 

(see MASS STORAGE IS) 

file name 

literal 

depends on volume’s format 
(see Glossary) 

LIF protect 
code 

literal; first two non-blank characters 
are significant 

> not allowed 

volume specifier 

literal 

(see MASS STORAGE IS) 


Example Statements 

STORE Filename$&Vol$ 

STORE "Dir<SRM_RW_pass>/Program" 

STORE KEY "Typing.aids" 

STORE KEY "KEYS:REMOTE" 

STORE KEY "/USERS/MARK/TYPING" 

Semantics 

In all STORE statements, an error will occur if the storage media cannot be 
found, the media or directory is full, or the file specified already exists. Also, 
if a LIF protect code is specified, it will be applied to the new LIF file. To 
update a file which already exists, see RE-STORE. 

STORE 

The STORE statement creates a PROG file and stores an internal form of the 
program into that file. 
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STORE KEY 

STORE KEY creates a file of type BDAT, and stores the current typing-aid, 
softkey definitions (not ON KEY softkey definitions) into it. These definitions 
may subsequently be reloaded with the LOAD KEY statement. 

For each defined typing-aid softkey, an integer and a string are sent to the file. 
The integer is the key number, and the string is the key definition. The data 
is written with FORMAT OFF (see the OUTPUT statement). Keys with no 
definition are not written to the file. 

HFS Permissions 

In order to STORE a file on an HFS volume, you need to have W (write) and 
X (search) permission on the immediately superior directory, as well as X 
permission on all other superior directories. 

When a file is stored on an HFS volume, access permission bits are set to 
RW-RW-RW-. You can modify the access permission bits with PERMIT, if 
desired. 

DFS and HFS File Headers 

On DFS or HFS volumes, STORE creates a PROG file that contains a 
512-byte header (at the beginning of the file’s contents). This header allows 
the BASIC system to recognize the file as being a PROG file. (The header is 
handled automatically by the BASIC system, so you do not have to take any 
special actions.) 

SRM Passwords and Exclusive Mode 

In order to STORE an SRM file, you need to have R (read) and W (write) 
capabilities on the immediately superior directory, and R capabilities on all 
other superior directories. 

Including an SRM password with the file name does not protect the file. 

You must use PROTECT to assign passwords. You will not receive an error 
message for including a password, but a password in the file name portion of 
the STORE statement will be ignored. 
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STORE opens the remote file in exclusive mode (denoted as LOCK in a CAT 
listing) and enforces that status on the file until the STORE is complete. 
While in exclusive mode, the file is inaccessible to all SRM workstations other 
than the one executing the STORE. 
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Supported on 
Option Required 
Keyboard Executable 
Programmable 
In an IF ... THEN ... 


UX WS DOS* 

None 

Yes 

No 

No 


The command stores the entire BASIC operating system currently in 
memory including any BINs that are loaded (use only with BASIC/WS or 
BASIC/DOS). 


(store system) -* 


file 

specifier 


H 


literal form of file specifier: 



Item 

Description 

Range 

file specifier 

string expression 

(see drawing) 

directory path 

literal 

(see MASS STORAGE IS) 

file name 

literal 

(see Semantics) 

volume specifier 

literal 

(see MASS STORAGE IS) 
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Example Statements 

STORE SYSTEM "SYSTEM_BA5:,700" 

STORE SYSTEM "BACKUP1” 

STORE SYSTEM "SYSTEM.Bl:REMOTE" 

STORE SYSTEM "/SYSTEMS/SYSTEM.NEW" 

STORE SYSTEM "/SYS.HFS" 

Semantics 

If the file name already exists, an error is reported. 

On LIF volumes, SYSTM file names can be up to 10 characters long; on SRM 
volumes, they may be up to 16 characters long. 

On HFS volumes, SYSTM file names may only be up to 9 characters long, 
since the HFS loader assumes that strings will be terminated with the null 
character, CHR$(0). In addition, SYSTM file names on HFS volumes less 
than 9 characters long will be padded with null characters to a length of 
10 characters. This may cause unexpected results, since null characters act 
as “wild cards” on HFS volumes. For instance, suppose that there are two 
SYSTM files on the same HFS volume named SYSTEM_BA and SYSTEMJB, 
and that they are listed as IB and 2B, respectively, by the Boot ROM. Typing 
IB will boot SYSTEMJ3A, as expected. However, typing 2B will also boot 
SYSTEM_BA because of the null (wild card) character in the 9th position in 
the SYSTM file named SYSTEMJ3. 

The BASIC system and any BINs in memory are stored in the SYSTM file. If 
the file name begins with SYSTEM., the Boot ROM can find it and load it at 
power up or SYSBOOT. (Note that Boot ROM 3.0 and A, and later versions, 
can find and load files beginning with SYS.) On SRM, the system must be 
located in /SYSTEMS for the Boot ROM to find it. On HFS, the system must 
be stored in the root (“/”) for the Boot ROM to find it. 

Note that if you did a SCRATCH BIN to remove the CRT driver you did not 
need, and then stored the system, when you reboot, the CRT driver for the 
other display is not available. If the CRT needs the other driver, you cannot 
use the display. Execute a LOAD BIN command to load the needed driver. 

STORE SYSTEM cannot be used with ROM BASIC systems. 
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HFS Permissions and File Headers 

In order to use STORE SYSTEM on an HFS volume, you need to have W 
(write) and X (search) permission on the root directory. ON HFS, you can 
STORE SYSTEM only to the root directory. 

Do not RENAME a file stored into the root directory of an HFS volume by 
STORE SYSTEM. 

A SYSTM file (or an HP-UX file stored by STORE SYSTEM) which is placed 
in the root directory of an HFS volume by COPY or LINK will not be found 
by the Boot ROM. 

The R (read) access capability on the system file created with STORE 
SYSTEM must be public to allow use of the file for booting. 

On HFS volumes, STORE SYSTEM creates an HP-UX file that contains a 
special header (at the beginning of the file’s contents) to make the file conform 
to the HP-UX “a.out” file format. (The header is handled automatically by the 
BASIC system, so you do not have to take any special actions.) 

SRM Access Capabilities 

In order to use STORE SYSTEM on an SRM volume, you need to have R 
(read) and W (write) capabilities on the immediately superior directory, and R 
capabilities on all other superior directories. 

The R (read) access capability on the system file created with STORE 
SYSTEM must be public to allow use of the file for booting. 

Including an SRM password with the file name does not protect the file. 

You must use PROTECT to assign passwords. You will not receive an error 
message for including a password, but a password in the file name will be 
ignored. 
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BASIC/UX Specifics 

STORE SYSTEM is not necessary nor supported on BASIC/UX as 
BASIC/UX is a unified system. 

BASIC/DOS Specifics 

A system stored from BASIC/DOS will not run correctly on BASIC/WS, or 
vice versa. 
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SUB 


Supported On 
Option Required 
Keyboard Executable 
Programmable 


In an IF ... THEN ... 


UX WS DOS IN* 

None 

No 

Yes 

No 


This is the first statement in a SUB subprogram and can specify the 
subprogram’s formal parameters. 
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SUB 


Item 

Description 

Range 

subprogram 

name 

name of the SUB subprogram 

any valid name 

numeric name 

name of a numeric variable 

any valid name 

string name 

name of a string variable 

any valid name 

I/O path name 

name assigned to a device, devices, or 
mass storage file 

any valid name (see 

ASSIGN) 

program 

segment 

any number of contiguous program 
lines not containing the beginning 
or end of a main program or 
subprogram 



Example Statements 

SUB Parse(String$) 

SUB Transform(®Printer,INTEGER Array(*).OPTIONAL Text$) 
SUB Complex_sub(COMPLEX Real.imag) 


Semantics 

SUB subprograms must appear after the main program. The first line of the 
subprogram must be a SUB statement. The last line must be a SUBEND 
statement. Comments after the SUBEND are considered to be part of the 
subprogram. 

Parameters to the left of the keyword OPTIONAL are required and must be 
supplied whenever the subprogram is invoked (see CALL). Parameters to the 
right of OPTIONAL are optional, and only need to be supplied if they are 
needed for a specific operation. Optional parameters are associated from left 
to right with any remaining pass parameters until the pass parameter list is 
exhausted. An error is generated if the subprogram tries to use an optional 
parameter which did not have a value passed to it. The function NPAR can be 
used to determine the number of parameters supplied by the CALL statement 
invoking the subprogram. 
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Variables in a subprogram’s formal parameter list may not be duplicated in 
COM or other declaratory statements within the subprogram. A subprogram 
may not contain any SUB statements, or DEF FN statements. Subprograms 
can be called recursively and may contain local variables. A unique labeled 
COM must be used if the local variables are to preserve their values between 
invocations of the subprogram. 

SUBEXIT may be used to leave the subprogram at some point other than the 
SUBEND. Multiple SUBEXITs are allowed, and SUBEXIT may appear in an 
IF ... THEN statement. SUBEND is prohibited in IF ... THEN statements, 
and may only occur once in a subprogram. ERROR SUBEXIT may be used in 
place of SUBEXIT. 

If you want to use a formal parameter as a BUFFER, it must be declared as a 
BUFFER in both the formal parameter list and the calling context. 


S 
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See the SUB statement. 
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SUBEXIT 


Supported On 
Option Required 
Keyboard Executable 
Programmable 


In an IF... THEN... 


UX WS DOS IN 

None 

No 

Yes 

Yes 


This statement may be used to return from a SUB subprogram at some 
point other than the SUBEND statement. It allows multiple exits from a 
subprogram. 

See also ERROR SUBEXIT. 


( SUBEXIT )-H 
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Supported On 
Option Required 
Keyboard Executable 
P rogr ammable 


In an IF ... THEN ... 


UX WS DOS 

MAT 

Yes 

Yes 

Yes 


This function returns the sum of all elements of a numeric array. The value 
returned is of the same type as the array. 


HD- 


Item 

Description 

Range 

array name 

name of a numeric array 

any valid name 


Example Statements 

Array_sum=SUM (A) 
Sum_squares=SUM(Squares) 
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SUSPEND INTERACTIVE 


Supported On 
Option Required 
Keyboard Executable 
Programmable 


In an IF ... THEN ... 


UX WS DOS 

None 

Yes 

Yes 

Yes 


This statement disables the f execute] , f enter] , fReturn ] , f pause) , [stop] , 
[clr l/o] , ( Break ] , and (optionally) [reset] key functions during a running 
program. 


C 


SUSPEND INTERACTIVE 



Example Statements 

SUSPEND INTERACTIVE,RESET 

IF NOT Kbd_flag THEN SUSPEND INTERACTIVE 

Semantics 

Execution of a PAUSE statement, a TRACE PAUSE statement, or a fatal 
execution error temporarily restores the suspended key functions. CONTINUE 
after a PAUSE will again disable the keys. 

SUSPEND INTERACTIVE is cancelled by RESUME INTERACTIVE, STOP, 
END, RUN, SCRATCH, GET, LOAD, or [reset ] . Although LOAD cancels 
SUSPEND INTERACTIVE, LOADSUB does not. SUSPEND INTERACTIVE 
has no effect unless a program is running. 

Note Suspending the [reset] key will prevent you from stopping a 

program before it ends. 


[execute) , [enter ) , and [ Return 1 can still be used to respond to an ENTER or 
INPUT statement, but cannot be used for live keyboard execution. 
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SWEDISH 

See the LEXICAL ORDER IS statement. 
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SYMBOL 


Supported On 
Option Required 
Keyboard Executable 
Programmable 
In an IF ... THEN ... 


UX WS DOS 

GRAPHX 

Yes 

Yes 

Yes 


This statement allows labelling with user-defined symbols. 


Q SYMBOL 


Yh 55 



Item 

Description 

Range 

array name 

name of a two-dimensional, 

any valid name 


two-column or three-column REAL 



array 



Example Statements 

SYMBOL My_char(*) 

SYMBOL Logo(*>,FILL,EDGE 

Semantics 

The user-defined symbol is created with moves and draws defined in a symbol 
coordinate system. The symbol coordinate system is a rectangular area nine 
units wide and fifteen units high, that is, a character cell. A symbol can 
extend outside the limits of the 9x15 symbol coordinate system rectangle. 

A symbol defined in the symbol coordinate system is affected by the label 
transformations CSIZE, LDIR, and LORG. The symbol is drawn using the 
current pen and line type, and it will be clipped at the current clip boundary. 
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When defining a symbol in the symbol coordinate system, coordinates may be 
outside the 9x15 character cell; thus, characters can be made which are several 
character cells wide and several character cells high. For this reason, the 
current pen position is not updated to the next character’s reference point, but 
it remains at the last X,Y coordinate specified in the array. A move is made 
to the first point regardless of the value in the third column of that row in the 
array. 

The symbol may have polygons defined in its data, and the polygons may be 
filled and/or edged. The fill color and pen number/line type used are those 
defined at the time the polygon is closed. 

FILL and EDGE 

When FILL or EDGE is specified, each sequence of two or more lines forms a 
polygon. The polygon begins at the first point on the sequence, includes each 
successive point, and the final point is connected or closed back to the first 
point. A polygon is closed when the end of the array is reached, or when the 
value in the third column is an even number less than three, or in the range 5 
to 8 or 10 to 15. 

If FILL and/or EDGE are specified on the SYMBOL statement itself, it causes 
the polygons defined within it to be filled with the current fill color and/or 
edged with the current pen color. If polygon mode is entered from within the 
array, and the FILL/EDGE directive for that series of polygons differs from 
the FILL/EDGE directive on the SYMBOL statement itself, the directive in 
the array replaces the directive on the statement. In other words, if a “start 
polygon mode” operation selector (a 6, 10, or 11) is encountered, any current 
FILL/EDGE directive (whether specified by a keyword or an operation 
selector) is replaced by the new FILL/EDGE directive. 

If FILL and EDGE are both declared on the SYMBOL statement, FILL occurs 
first. If neither one is specified, simple line drawing mode is assumed; that is, 
polygon closure does not take place. 

If you attempt to fill a figure on an HPGL plotter, the figure will not be filled, 
but will be edged, regardless of the directives on the statement. 
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Applicable Graphics Transformations 



Scaling 

PIVOT 

CSIZE 

LDIR 

PDIR 

Lines (generated by moves and 
draws) 

X 

X 



[4] 

Polygons and rectangles 

X 

X 



X 

Characters (generated by 

LABEL) 



X 

X 


Axes (generated by AXES & 
GRID) 

X 





Location of Labels 

[1] 

[3] 


[2] 



^he starting point for labels drawn after lines or axes is affected by scaling. 
2 The starting point for labels drawn after other labels is affected by LDIR. 
3 The starting point for labels drawn after lines or axes is affected by PIVOT. 
4 RPLOT and IPLOT are affected by PDIR. 

When using a SYMBOL statement, the following table of operation selectors 
applies. An operation selector is the value in the third column of a row of 
the array to be plotted. The array must be a two-dimensional, two-column 
or three-column array. If the third column exists, it will contain operation 
selectors which instruct the computer to carry out certain operations. Polygons 
may be defined, edged (using the current pen), filled (using the current fill 
color), pen and line type may be selected, and so forth. See the list below. 
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Column 1 

Column 2 

Operation 

Selector 

Meaning 

X 

Y 

-2 

Pen up before moving 

X 

Y 

-1 

Pen down before moving 

X 

Y 

0 

Pen up after moving (Same as -f 2) 

X 

Y 

1 

Pen down after moving 

X 

Y 

2 

Pen up after moving 

pen number 

ignored 

3 

Select pen 

line type 

repeat value 

4 

Select line type 

color 

ignored 

5 

Color value 

ignored 

ignored 

6 

Start polygon mode with FILL 

ignored 

ignored 

7 

End polygon mode 

ignored 

ignored 

8 

End of data for array 

ignored 

ignored 

9 

NOP (no operation) 

ignored 

ignored 

10 

Start polygon mode with EDGE 

ignored 

ignored 

11 

Start polygon mode with FILL and 
EDGE 

ignored 

ignored 

12 

Draw a FRAME 

pen number 

ignored 

13 

Area pen value 

red value 

green value 

14 

Color 

blue value 

ignored 

15 

Value 

ignored 

ignored 

>15 

Ignored 


Moving and Drawing 

If the operation selector is less than or equal to two, it is interpreted in exactly 
the same manner as the third parameter in a non-array SYMBOL statement. 
Even is up, odd is down, positive is after pen motion, negative is before pen 
motion. Zero is considered positive. 

Selecting Pens 

An operation selector of 3 selects a pen. The value in column one is the pen 
number desired. The value in column two is ignored. 


S-100 SAVE - SYSTEMS 









SYMBOL 


Selecting Line Types 

An operation selector of 4 selects a line type. The line type (column one) 
selects the pattern, and the repeat value (column two) is the length in GDUs 
that the line extends before a single occurrence of the pattern is finished and it 
starts over. On the CRT, the repeat value is evaluated and rounded down to 
the next multiple of 5, with 5 as the minimum. 

Selecting a Fill Color 

Operation selector 13 selects a pen from the color map with which to do 
area fills. This works identically to the AREA PEN statement. Column one 
contains the pen number. 

Defining a Fill Color 

Operation selector 14 is used in conjunction with operation selector 15. Red 
and green are specified in columns one and two, respectively, and column three 
has the value 14. Following this row in the array (not necessarily immediately), 
is a row whose operation selector in column three has the value of 15. The first 
column in that row contains the blue value. These numbers range from 0 to 
32 767, where 0 is no color and 32 767 is full intensity. Operation selectors 14 
and 15 together comprise the equivalent of an AREA INTENSITY statement, 
which means it can be used on a monochromatic, gray scale, or color display. 

Operation selector 15 actually puts the area intensity into effect, but only if an 
operation selector 14 has already been received. 

Operation selector 5 is another way to select a fill color. The color selection is 
through a Red-Green-Blue (RGB) color model. The first column is encoded in 
the following manner. There are three groups of five bits right-justified in the 
word; that is, the most significant bit in the word is ignored. Each group of five 
bits contains a number which determines the intensity of the corresponding 
color component, which ranges from zero to sixteen. The value in each field 
will be sixteen minus the intensity of the color component. For example, if the 
value in the first column of the array is zero, all three five-bit values would 
thus be zero. Sixteen minus zero in all three cases would turn on all three color 
components to full intensity, and the resultant color would be a bright white. 
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Assuming you have the desired intensities (which range from 0 thru 1) for red, 
green, and blue in the variables R, G, and B, respectively, the value for the first 
column in the array could be defined thus: 

Array(Row,1)=SHIFT(16*(1-B),-10)+SHIFT(16*(l-G),-5)+16*(l-R) 

If there is a pen color in the color map similar to that which you request here, 
that non-dithered color will be used. If there is not a similar color, you will get 
a dithered pattern. 

If you are using a gray scale display, Operation selector 5 uses the five bit 
values of the RGB color specified to calculate luminosity. The resulting gray 
luminosity is then used as the area fill. For detailed information on gray 
scale calculations, see the chapter “More About Color Graphics” in the 
HP BASIC 6.2 Advanced Programming Techniques manual. 

Polygons 

A six, ten, or eleven in the third column of the array begins a “polygon mode”. 
If the operation selector is 6, the polygon will be filled with the current fill 
color. If the operation selector is 10, the polygon will be edged with the current 
pen number and line type. If the operation selector is 11, the polygon will 
be both filled and edged. Many individual polygons can be filled without 
terminating the mode with an operation selector 7. This can be done by 
specifying several series of draws separated by moves. The first and second 
columns are ignored and should not contain the X and Y values of the first 
point of a polygon. 

Operation selector 7 in the third column of a plotted array terminates 
definition of a polygon to be edged and/or filled and also terminates the 
polygon mode (entered by operation selectors 6, 10, or 11). The values in the 
first and second columns are ignored, and the X and Y values of the last data 
point should not be in them. Edging and/or filling of the most recent polygon 
will begin immediately upon encountering this operation selector. 
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Doing a FRAME 

Operation selector 12 does a FRAME around the current soft-clip limits. Soft 
clip limits cannot be changed from within the SYMBOL statement, so one 
probably would not have more than one operation selector 12 in an array to 
SYMBOL, since the last FRAME will overwrite all the previous ones. 

Premature Termination 

Operation selector 8 causes the SYMBOL statement to be terminated. The 
SYMBOL statement will successfully terminate if the actual end of the array 
has been reached, so the use of operation selector 8 is optional. 

Ignoring Selected Rows in the Array 

Operation selector 9 causes the row of the array it is in to be ignored. Any 
operation selector greater than 15 is also ignored, but operation selector 
9 is retained for compatibility reasons. Operation selectors less than —2 
are not ignored. If the value in the third column is less than zero, only 
evenness/oddness is considered. 

If you attempt to fill a figure on an HPGL plotter, the figure will not be filled, 
but will be edged, regardless of the directives on the statement. 
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SYSBOOT 


Supported on 
Option Required 
Keyboard Executable 
Programmable 
In an IF ... THEN 


UX* WS DOS 

None 

Yes 

Yes 

Yes 


This command returns control to the Boot ROM to restart the system 
configuration and selection process. 


(sysboot)- 


U in. if" 


file 
specifier 


literal form of file specifier: 



Item 

Description 

Range 

file specifier 

string expression, specifying a 

SYSTM file to be booted 

(see drawing) 

file name 

literal 

(see Semantics) 

volume specifier 

literal 

(see MASS STORAGE IS) 


Example Statements 

SYSBOOT 

SYSBOOT Sys_file$ftVolume$ 
SYSBOOT "SYSTEM_BA5:,700" 
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Semantics 

If no file specifier is included, the normal Boot ROM power-up search sequence 
is initiated. (See Using HP BASIC/WS 6.2 or Using HP BASIC/UX 6.2 for a 
sequence of mass storage devices searched.) 

If a file specifier is included, it must a valid LIF file specifier (10 characters 
or less). The Boot ROM restricts the file name, if included, to 10 characters. 
System names on SRM can be up to 16 characters. To boot a system whose 
name is more than 10 characters, do not specify the file name and use the Boot 
ROM to select the correct file. 

If no volume specifier is included in the file specifier, the current default volume 
is assumed. 

To boot a system from the SRM, public read access is required and the 
system must be located in /SYSTEMS. The directory path, /SYSTEMS 
must be omitted from the file specifier. The Boot ROM looks for the file in 
/SYSTEMS. 

To boot from HFS the system must be located in the root directory (/). 

System names on HFS must be 9 characters or less. 

BASIC/UX Specifics 

Not supported on BASIC/UX. It generates an error. 

BASIC/DOS Specifics 

If a file specifier is included, it is ignored. Any boot options given on the 
BASIC command line when BASIC/DOS is first invoked will be in effect. 
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Supported On 
Option Required 
Keyboard Executable 
Programmable 


In an IF ... THEN ... 


UX WS DOS 

KBD 

Yes 

Yes 

Yes 


This statement changes the softkey definitions on an ITF keyboard to the 
System menu. 


C 


SYSTEM KEYS 




Example Statements 

SYSTEM KEYS 

IF Change.keys THEN SYSTEM KEYS 

Semantics 

This statement only affects the normal mode of the ITF Keyboard (i.e. it does 
nothing on an HP 98203A/B/C Keyboard and causes no visible change on an 
ITF Keyboard when the Keyboard Compatibility Mode, KBD CMODE, is on). 

Note that the functionality of this statement can be achieved through KBD 
CONTROL register 2. 

For information on the softkey definitions, see Using HP BASIC/WS 6.2 or 
Using HP BASIC/UX 6.2. 
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SYSTEM PRIORITY 


Supported On 
Option Required 
Keyboard Executable 
Programmable 


In an IF... THEN... 


UX WS DOS IN 

None 

Yes 

Yes 

Yes 


This statement sets system priority to a specified value. 


(system priority) -* new priority 


Item 

Description 

Range 

new priority 

numeric expression, rounded to an 
integer 

0 through 15 


Example Statements 

SYSTEM PRIORITY Old 

IF Critical.code THEN SYSTEM PRIORITY 15 

Semantics 

Zero is the lowest user-specifiable priority and 15 is the highest. The END, 
ERROR, and TIMEOUT events have an effective priority higher than the 
highest user-specifiable priority. If no SYSTEM PRIORITY has been executed, 
minimum system priority is 0. 

This statement establishes the minimum for system priority. Once the 
minimum system priority is raised with this statement, any events of equal 
or lower priority will be logged but not serviced. In order to allow service of 
lower-priority events, minimum system priority must be explicitly lowered. 

If SYSTEM PRIORITY is used to change the minimum system priority in a 
subprogram context, the former value is restored when the context is exited. 
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SYSTEM PRIORITY 

Error 427 results if SYSTEM PRIORITY is executed in a service routine for an 
ON ERROR GOSUB or ON ERROR CALL statement. 


S 
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SYSTEMS 


Supported On 
Option Required 
Keyboard Executable 
Programmable 


In an IF ... THEN ... 


UX WS DOS* IN* 

None 

Yes 

Yes 

Yes 


This function returns a string containing system status and configuration 
information. 


( SYSTEMS kJj-h 


Item 

Description 

Range 

topic specifier 

string expression 

see the following table 


Example Statements 

IF SYSTEMS("TRIG MODE")="RAD" THEN CALL Change.mode 
System_prior=VAL(SYSTEMS("SYSTEM PRIORITY")) 
Version$=SYSTEM$("VERSION:OS") 


Semantics 

The topic specifier is used to specify what system configuration information 
SYSTEMS will return. The following table lists the valid topic specifiers and 
the information returned for each one. 
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Topic Specifier 

Information Returned 

AVAILABLE MEMORY 

Bytes of available memory. BASIC/UX returns both the 
physical RAM available before swapping becomes necessary 
and available workspace. 

CONVERSION 

A string containing the current contents of the keyboard 

BUFFER 

input conversion buffer (Japanese localized BASIC/WS 
only). (Requires INPUT) 

CRT ID 

6: nnwxyzaa 

6 distinguishes this format from Series 500 BASIC 

nn CRT width in characters 

w H=CRT highlights available, space=No highlights 

x C=Color available, M= Monochrome/Gray scale 

V G=Graphics available, space=No graphics 

z B=Bit mapped display, space=Not bit mapped 

aa highest graphics pen number, 1 if monochrome, 15 

if 236C, 2~n-l if bit mapped 

DICTIONARY 

A string containing the current file specifier for system 

IS:SYSTEM 

input conversion dictionaries (Japanese localized 

BASIC/WS only). If no dictionary is assigned, the null 
string is returned. (Requires INPUT) 

DICTIONARY 

A string containing the current file specifier for 

IS:USER 

user-defined input conversion dictionaries (Japanese 
localized BASIC/WS only). If no dictionary is assigned, 
the null string is returned.(Requires INPUT) 

DUMP DEVICE IS 

A string containing numerals which specify the device 
selector for the currently assigned DUMP DEVICE IS 
device. 
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Topic Specifier 

Information Returned 

GFONT IS 

A string containing the file specifier for the vector 
fonts used by LABEL (BASIC/WS only). If no file 
has been assigned, the null string is returned.(Requires 
LANGUAGE) 

GRAPHICS INPUT IS 

A string containing numerals which specify the device 
selector for the currently assigned GRAPHICS INPUT IS 
device. Zero is returned if no device is currently selected. 
(Requires GRAPH) 

KBD LINE 

A string containing the current contents of the keyboard 
input line(s). Note that this operation does not change the 
contents of the line(s). 

KEYBOARD 

ASCII, BELGIAN, CANADIAN ENGLISH, CANADIAN 

LANGUAGE 

FRENCH, DANISH, DUTCH, FINNISH, FRENCH, 
GERMAN, ITALIAN, KANJI, KATAKANA, LATIN, 
NORWEGIAN, SPANISH, SWEDISH, SWISS FRENCH, 
SWISS GERMAN, SWISS FRENCH*, SWISS 

GERMAN*, or UNITED KINGDOM (Requires LEX) 

LANGUAGE 

A string containing the current system language 
(BASIC/WS only). If no localized LANGUAGE binary 
is loaded or if CRTD is not active, the returned string 
is the null string. If a localized LANGUAGE binary is 
loaded and CRTD is active, then the returned string is the 
language supported by LANGUAGE, such as JAPANESE. 
(Requires LANGUAGE) 

LEXICAL ORDER IS 

ASCII, GERMAN, FRENCH, SPANISH, SWEDISH or 
USER DEFINED (Requires LEX) 

MASS MEMORY 

XOOOYZOOOOOOOOOO 

X=Number of internal disk drives Y=Number of initialized 
EPROM cards Z=Number of bubble memory cards If Y or 

Z exceed 9, an asterisk appears. 

BASIC DOS and BASIC/UX: value is always a string of 

0’s as internal LIF disk drives, EPROM or bubble memory 
cards are not supported. 
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Topic Specifier 

Information Returned 

MASS STORAGE IS, 

The mass storage unit specifier of the current MASS 

MSI 

STORAGE IS device, as it appears in a CAT heading. 

PLOTTER IS 

A string containing numerals which specify the device 
selector of the current PLOTTER IS device or the path 
name of the current PLOTTER IS file. (Requires GRAPH) 

PRINTALL IS 

A string containing numerals which specify the device 
selector of the current PRINTALL IS device. 

PRINTER IS 

A string containing numerals which specify the device 
selector of the current PRINTER IS device or the path 
name of the current PRINTER IS file. 

PROCESS ID 

Returns the process identifier of the main process. 
BASIC/WS and BASIC/DOS always returns 0.(Requires 
CRTX) 

SERIAL NUMBER 

Returns the serial number from an HP HIL ID module if 
present; otherwise it returns the null string. 

SYSTEM ID 

S300:40 on Series 300 computers with an MC68040 
processor; or S300:30 on Series 300 computers with an 
MC68030 processor; or S300:20 on Series 300 computers 
with an MC68020 processor; or bytes 15 through 21 of the 
ID PROM in a Series 200 computer (if present); or 9816, 
9826A, or 9836A padded with trailing spaces to make a 
seven character string; PC300 for 82300 Measurement 
Coprocessor or PC300:30 for 82324 High Performance 
Measurement Coprocessor. 

SYSTEM PRIORITY 

A string containing numerals which specify the current 
system priority. 

TIMEZONE IS 

A string specifying the seconds from Greenwich Mean 

Time that represent the current timezone value. (Requires 
RMBUX,CLOCK) 

TRIG MODE 

DEG or RAD 
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Topic Specifier 

Information Returned 

VERSION: option name 

A string containing numerals which specify the revision 
number of the specified binary (also displayed after LOAD 
BIN or LIST BIN) or option. BASIC, BCD, BUBBLE, 
CLOCK, COMPLEX, CRTA, CRTB, CRTX, CS80, 
DCOMM, DFS, DISC, EDIT, EPROM, ERR, FHPIB, 
GPIO, GRAPH, GRAPHX, HFS, HP9885, HPIB, IO, 

KBD, LEX, MAT, MS, PDEV, RMBUX SERIAL, SRM, 
TRANS, XREF, etc.: VERSION:OS returns the operating 
system version and name. 

VERSION ispeciaLfile 

A string containing the revision of the specified graphics 
font file or dictionary file (Japanese localized BASIC/WS 
only). If the file has not been assigned (using GFONT IS, 
DICTIONARY is), the null string is returned. 

WILDCARDS 

Returns: OFF: DOS: UX:<esc.char>. 

WINDOW SYSTEM 

Returns data on the window environment.(BASIC/UX/WS 
only) “X Windows”—for the X Windows manager 
“Console”—for the bare screen console (or BASIC/WS or 
BASIC/DOS with RMBUX binary) “Terminal”—for a 
terminal “Windows/9000”—for the HP Windows/9000 


manager. 


SYSTEMS with SRM, DFS, and HFS Systems 

When SYSTEMS of MASS STORAGE IS (MSI), PLOTTER IS, or PRINTER 
IS is executed on a system using SRM, DFS or HFS volumes, the information 
returned includes the full file specifier describing the file or directory about 
which the information is requested. (SRM passwords are not included in the 
specifier.) 

The system remembers a maximum of 160 characters for any one specifier. If a 
specifier contains more than 160 characters, the excess characters are removed 
from the beginning of the specifier and are not retained. An asterisk (*) as 
the left-most character in the specifier indicates that leading characters were 
truncated for the function. 
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BASIC/UX Specifics 

The system remembers a maximum of 1024 characters for any one specifier. 

If a specifier contains more than 1024 characters, the excess characters are 
removed from the beginning of the specifier and are not retained. An asterisk 
(*) as the left-most character in the specifier indicates that leading characters 
were truncated for the function. 

BASIC/DOS Specifics 

Four additional keywords are provided for BASIC/DOS: 


Topic Specifier 

Information Returned 

DISPLAY SIZE 

PIXEL RATIO 

VERSION :MCP_H W 

VERSION :MCP_S W 

Viewable size of display in pixels in <horiz>x<vert> 
format (e.g., “648 x 480”). 

The X/Y ratio of the physical pixel size on the display 
(e.g., 1.00 for VGA). 

“82300” for Measurement Coprocessor, “82324” for High 
Performance Measurement Coprocessor. 

Version of Measurement Coprocessor Software being used 
(e.g., “D 00.00”). 
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TAB 


See the PRINT and DISP statements. 
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TABXY 


TABXY 

See the PRINT statement. 


T 
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TALK 

See the SEND statement. 



TAN 


TAN 


Supported On 
Option Required 
Keyboard Executable 
Programmable 
In an IF ... THEN ... 


UX WS DOS IN 

None 

Yes 

Yes 

Yes 


This function returns the tangent of the angle represented by the argument. 





Range 

Item 

Description/Default 

Restrictions 

argument 

numeric expression in the current 

absolute values less than: 


units of angle when arguments are 

8.541 563 906 E+9 deg. 


INTEGER or REAL. 

or 1.490 784 13 E+8 rad. 


numeric expression in radians when 
the argument is COMPLEX. 

for INTEGER and REAL 
arguments; see “Range 
Restriction Specifics” for 
COMPLEX arguments 


Examples Statements 

Tangent=TAN(Angle) 

PRINT "Tangent of ";Z;"=";TAN(Z) 


Semantics 

Error 31 is reported for INTEGER and REAL arguments when trying to 
compute the TAN of an odd multiple of 90 degrees. 

If the argument is REAL or INTEGER, the value returned is REAL. If the 
argument is COMPLEX, the value returned is COMPLEX. 
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TAN 


To compute the TAN of a COMPLEX value, the COMPLEX binary must be 
loaded. 

Range Restriction Specifics 

The formula used for computing the TAN of a COMPLEX argument is 
illustrated by the following BASIC code segment. 

100 Factor=C0S(2*Real_arg)+C0SH(2*Imag_arg) 

110 ! 

120 Real_result=SIN(2*Real_arg)/Factor 
130 Imag_result=SINH(2*Imag_arg)/Factor 

where Real.arg is the real part the COMPLEX argument and Imag.arg is the 
imaginary part of the COMPLEX argument. Some values of a COMPLEX 
argument may cause errors in this computation. For example, 

TAM(CMPLXC0,710)) 

will cause error 22 due to the C0SH(2*Imag_part) calculation. 

Note that any COMPLEX function whose definition includes a sine or cosine 
function will be evaluated in the radian mode regardless of the current angle 
mode (i.e. RAD or DEG). 
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TANH 


Supported On 
Option Required 
Keyboard Executable 
Programmable 


In an IF ... THEN ... 


UX WS DOS 

COMPLEX 

Yes 

Yes 

Yes 


This function returns the hyperbolic tangent of a numeric expression. 





Range 

Item 

Description 

Restrictions 

argument 

numeric expression 

any value for INTEGER 
or REAL arguments; 
see “Range Restriction 
Specifics” for COMPLEX 
arguments. 


Example Statements 

Result»TAMH(-5.7723) 

PRINT "Hyperbolic Tangent = TANH(Expression) 


Semantics 

If an INTEGER or REAL argument is given, this function returns a REAL 
value. If a COMPLEX argument is given, this function returns a COMPLEX 
value. 
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Range Restriction Specifics 

For COMPLEX arguments, the formula for computing TANH is: 

100 Factor=C0SH(2*Real_arg)+C0S(2*Imag_arg) 

110 ! 

120 Real_result=SINH(2*Real_arg)/Factor 
130 Imag_result=SIN(2*Imag_arg)/Factor 

where Real .part is the real part of the COMPLEX argument and Imag.part 
is the imaginary part. Some values of the argument may cause errors in this 
computation. For example: 

TANH(CMPLX(710,3)) 

will cause error 22 REAL overflow due to the SINH(2*Real_part) calculation. 



TIME 


TIME 


Supported On 
Option Required 
Keyboard Executable 
Programmable 


In an IF ... THEN ... 


UX WS DOS 

CLOCK 

Yes 

Yes 

Yes 


This function converts the formatted time of day (HH:MM:SS), into the 
number of seconds past midnight. (For information on using TIME as 
a secondary keyword, see the OFF TIME, ON TIME, and SET TIME 
statements.) 



literal form of time of day 



T 


Item 

Description 

Range 

time of day 

string expression representing the 
time in 24-hour format 

(see drawing) 

hours 

literal 

0 through 23 

minutes 

literal 

0 through 59 

seconds 

literal; default = 0 

0 through 59.99 

delimiter 

literal; single character 

(see text) 
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Example Statements 

Seconds=TIME(T$) 

SET TIME TIME("8:37:30 M ) 

ON TIME TIME("12:12") GOSUB Food.food 

Semantics 

TIME returns a REAL whole number, in the range 0 through 86 399, 
equivalent to the number of seconds past midnight. 

While any number of non-numeric characters may be used as a delimiter, a 
single colon is recommended. Leading blanks and non-numeric characters are 
ignored. 


T 
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TIMES 


Supported On 
Option Required 
Keyboard Executable 
Programmable 


In an IF ... THEN ... 


UX WS DOS 

CLOCK 

Yes 

Yes 

Yes 


This function converts the number of seconds past midnight into a string 
representing the time of day (HH:MM:SS). 



Item 

Description 

Range 

seconds 

numeric expression, truncated to 

0 through 86 399 


the nearest second; seconds past 



midnight 



Example Statements 

DISP "The time is: ";TIME$(TIMEDATE) 

PRINT TIME$(45296) 

Semantics 

TIMES takes time (in seconds) and returns the time of day in the form 
HH:MM:SS, where HH represents hours, MM represents minutes, and SS 
represents seconds. A modulo 86 400 is performed on the parameter before it is 
formatted as a time of day. 
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TIMEDATE 


Supported on 
Option Required 
Keyboard Executable 
Programmable 


In an IF ... THEN ... 


UX WS DOS IN 

None 

Yes 

Yes 

Yes 


This function returns the current value of the real-time clock. (Also see the 
SET TIMEDATE statement.) 



TIMEDATE 




Example Statements 

Elapsed=TIMEDATE-TO 
DISP TIMEDATE MOD 86400 

Semantics 

The value returned by TIMEDATE represents the sum of the last time setting 
and the number of seconds that have elapsed since that setting was made. The 
volatile clock value set at power-on is 2.086 629 12 E+ll, which represents 
midnight March 1, 1900 (for BASIC/UX, the power-on value was the HP-UX 
time). If there is a battery-backed (non-volatile) clock, then the volatile clock 
is synchronized with it at power-up. If the computer is on an SRM system 
(and has no battery-backed clock), then the volatile clock is synchronized with 
the SRM clock when the SRM and DCOMM binaries are loaded. The clock 
values represent Julian time, expressed in seconds. The time value accumulates 
from that setting unless it is changed by SET TIME or SET TIMEDATE. 

The resolution of the TIMEDATE function is .01 seconds. If the clock is 
properly set, TIMEDATE MOD 86400 gives the number of seconds since midnight. 

See also TIMEZONE IS. 


T-12 TAB - TRN 


BASIC/UX Specifics 

Resolution is limited to 20 milliseconds. 

BASIC/DOS Specifics 

Resolution is limited to approximately 10 milliseconds. 


TIMEDATE 


T 


TAB-TRN T-13 



TIMEOUT 

See the OFF TIMEOUT and ON TIMEOUT statements. 
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TIMEZONE IS 


Supported On 
Option Required 
Keyboard Executable 
Programmable 


In an IF ... THEN ... 


UX WS DOS 

None 

Yes 

Yes 

Yes 


This statement specifies the offset from Greenwich Mean Time. 


Q TIMEZONE IS 


seconds 
from GMT 


Item 

Description 

Range 

seconds from 

numeric expression rounded to the 

0 through ±86 399.99 

GMT 

nearest hundredth 

(=24*60*60-0.01) 


Example Statements t 

TIMEZONE IS Hours_from_GMT*60*60 

TIMEZONE IS -7*3600 Mountain Standard Time 

TIMEZONE IS BASIC/UX only 

Semantics 

BASIC/WS and BASIC/DOS Specifics 

TIMEZONE specifies the number of seconds that will be added to the clock to 
calculate the “local” time (when it is set to Greenwich Mean Time, or GMT). 
Therefore TIMEZONE IS parameter’s value for the GMT timezone is 0. The 
TIMEZONE IS parameter’s value for the Mountain Standard timezone is 
—7x60x60, because it is 7 hours behind GMT. For each one-hour timezone to 
the east, add 3600 seconds to the parameter’s value; for each timezone to the 
west, subtract 3600 seconds. 
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TIMEZONE IS 


You can determine the current value of the TIMEZONE IS parameter by 
executing SYSTEM$(“TIMEZONE IS”). See SYSTEMS for details. 

Note If you have a battery-backed (non-volatile) clock, then you may 

need to first use SET TIMEDATE before using TIMEZONE IS 
and SET TIMEDATE as described above. Otherwise, the clock 
may initially be set to 1 March 1900, and SET TIMEDATE 
could generate a “parameter out of range” error (when it 
subtracts the TIMEZONE’s “offset from GMT” parameter from 
the specified clock value while calculating the GMT value to 
put into the clock register.) 

You can use STATUS register 4 of select code 32 to determine 
whether or not you have a battery-backed clock. 


HP-UX Compatibility 

This statement provides compatibility with HP-UX time stamps on files 
when switching back and forth between the BASIC and HP-UX operating 
systems. (If you will not be doing that, you do not need to use the TIMEZONE 
statement.) 

TIMEZONE is required for HP-UX compatibility when: 

■ The non-volatile clock is set to Greenwich Mean Time for HP-UX. 

■ The real-time clock is set to “local” time for BASIC. 

An HP-UX environment variable called TZ is used to calculate “local time”, 
which is an offset from GMT. Thus, when a time stamp (in GMT) is put on a 
file by HP-UX, the time value (printed in a directory listing) is derived with 
this formula: 

Local_time = HP-UX clock value (GMT) + TZ 

When using TIMEZONE for HP-UX compatibility, you can set the non-volatile 
(battery-backed) clock to GMT by the following sequence of commands: 

1. Specify the “local” offset to GMT with TIMEZONE IS. For example: 

TIMEZONE IS -7*3600 

2. Set the “local” time with SET TIMEDATE. For example: 
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TIMEZONE IS 


SET TIMEDATE DATE("5 Dec 1986")+TIME("09:00:00") 

(The actual value written into the battery-backed clock is the specified time 
minus the TIMEZONE IS value.) 

Note also that LIF volumes have “local time” stamps, while HFS volumes have 
GMT time stamps. 

BASIC/UX Specifics 

The TIMEZONE is set to the current HP-UX timezone in effect at the start 
of BASIC. Daylight savings time is automatically included. Any changes in 
timezone that occur after BASIC has started must be accounted for by the user 
with the TIMEZONE IS statement. 

Note that this statement does NOT reset the HP-UX timezone, even if the user 
is super-user. Instead it resets the timezone which BASIC keeps for itself 

TIMEZONE IS without a parameter resynchronizes the timezone with the 
current HP-UX timezone in effect (this does take into account Daylight Savings 
Time changes). This command will affect any previous SET TIME or SET 
TIMEDATE statements. The proper way to resynchronize the time, date, and 
timezone is to do the timezone first as in: 

TIMEZONE IS 
SET TIMEDATE 

You can determine the current value of the TIMEZONE IS parameter by 
executing SYSTEM$(“TIMEZONE IS”). See SYSTEMS for details. 

Workstation Compatibility 

This statement provides backward compatibility to the BASIC workstation. It 
is intended to provide compatibility with HP-UX time stamps on files when 
switching back and forth between the BASIC and HP-UX operating systems. 
Since the BASIC Workstation default timezone is synchronized with HP-UX 
at start-up time, this statement is generally NOT needed when working with 
BASIC Workstation. 
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TRACE ALL 


Supported on 
Option Required 
Keyboard Executable 
Programmable 
In an IF ... THEN ... 


UX WS DOS 

PDEV 

Yes 

Yes 

Yes 


This statement allows tracing program flow and variable assignments during 
program execution. 



Item 

Description 

Range 

beginning line 
number 

integer constant identifying a 
program line; Default = first program 
line 

1 through 32 766 

beginning line 
label 

name of a program line 

any valid name 

ending line 
number 

integer constant identifying a 
program line; Default = last program 
line 

1 through 32 766 

ending line 
label 

name of a program line 

any valid name 
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Example Statements 

TRACE ALL Sort 
TRACE ALL 1500,2450 

Semantics 

The entire program, or any part delimited by beginning and (if needed) ending 
line numbers or labels, may be traced. 

Tracing starts when the beginning line is first executed and continues until the 
ending line is executed. 

The ending line is not included in the trace output. The trace output stops 
immediately before the ending line is executed. When a line is traced, the line 
number and any variable which receives a new value is output to the system 
message line of the CRT. Any type of variable (string, numeric or array) can 
be displayed. For simple string and numeric variables, the name and the new 
value are displayed. For arrays, a message is displayed stating that the array 
has a new value rather than outputting the entire array contents. 

TRACE ALL output can also be printed on the PRINTALL printer, if 
PRINTALL is ON. TRACE ALL is disabled by TRACE OFF. The line 
numbers specified for TRACE ALL are not affected by REN. 
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TRACE OFF 


Supported On 
Option Required 
Keyboard Executable 
Programmable 


In an IF ... THEN ... 


UX WS DOS 

PDEV 

Yes 

Yes 

Yes 


This statement turns off all tracing activity. 



T 
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TRACE PAUSE 


TRACE PAUSE 


Supported On 
Option Required 
Keyboard Executable 
Programmable 


In an IF ... THEN ... 


UX WS DOS 

PDEV 

Yes 

Yes 

Yes 


This statement causes program execution to pause before executing the 
specified line, and displays the next line to be executed on the CRT. 


C 


TRACE PAUSE 


> 


paused 
line number 


paused 
line label 


Item 

Description 

Range 

paused line 

integer constant identifying a 

1 through 32 766 

number 

program line; Default = next 
program line 


paused line 
label 

name of a program line 

any valid name 


Example Statements 

TRACE PAUSE 

TRACE PAUSE Loop_end 


Semantics 

Not specifying a line for TRACE PAUSE results in the pause occurring before 
the next line is executed. Only one TRACE PAUSE can be active at a time. 
TRACE PAUSE is cancelled by TRACE OFF. 
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TRACK 


Supported On 
Option Required 
Keyboard Executable 
Programmable 


In an IF ... THEN ... 


UX WS DOS 

GRAPHX 

Yes 

Yes 

Yes 


This statement enables and disables tracking of the current locator position on 
the current display device. 




Item 

Description 

Range 

T 

display device 
selector 

numeric expression, rounded to an 
integer 

(see Glossary) 


Example Statements 

TRACK 709 IS ON 
TRACK Plot IS OFF 

Semantics 

The current locator is defined by a GRAPHICS INPUT IS statement, and the 
current display device is defined by a PLOTTER IS statement. If TRACK ... 
IS ON is executed, an echo on the current display device tracks the locator 
position during DIGITIZE statements. On a CRT, the echo is a 9-by-9-dot 
crosshair. On a plotter, the pen position tracks the locator. When a point is 
digitized, the echo is left at the location of the digitized point and tracking 
ceases. 
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TRACK 


The display device selector must match that used in the most recently executed 
PLOTTER IS statement, or error 708 results. 

Executing TRACK ... IS OFF disables tracking. 


T 
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TRANSFER 


Supported on 


Option Required 
Keyboard Executable 
Programmable 


In an IF ... THEN ... 


UX WS DOS* 

TRANS 

Yes 

Yes 


Yes 


This statement initiates unformatted I/O transfers. 


T 
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TRANSFER 


Item 

Description 

Range 

source name 

I/O path name assigned to a device, 
a group of devices, a mass storage 
file, pipe, or a buffer 

any valid name 

destination 

name 

I/O path name assigned to a device, 
a group of devices, a mass storage 
file, pipe, or a buffer 

any valid name 

number of 
bytes 

numeric expression, rounded to an 
integer 

1 through 2 31 —1 

character 

string expression with a length of 
zero or one 

— 

number of 
records 

numeric expression, rounded to an 
integer 

1 through 2 31 —1 


Example Statements 

TRANSFER CDevice TO CBuff 

TRANSFER CBuff TO «File;C0NT 

TRANSFER CPath TO CDestination;COUNT 256 

TRANSFER CSource TO CBuffer;DELIM 

TRANSFER CPath TO CBuffer;RECORDS 12,E0R(C0UNT 8) 

Semantics 

The TRANSFER statement allows unformatted data transfers between the 
computer and devices (mass storage drives are considered devices for this 
operation). Whenever possible, a TRANSFER takes place concurrently 
with continued program execution. Since no formatting is performed and 
the TRANSFER statement executes concurrently (overlapped) with regular 
program execution, the highest possible data transfer rate is achieved. 

Before a data transfer can take place, a buffer must be declared. Every 
TRANSFER will need a buffer as either its source or its destination. An 
outbound TRANSFER empties the buffer (source) while an inbound 
TRANSFER fills the buffer (destination). Device to device transfers and buffer 
to buffer transfers are not allowed. 
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TRANSFER 


Two types of buffers are available; named and unnamed. A named buffer 
is a REAL array, INTEGER array, COMPLEX array, or a string scalar 
declared with the keyword BUFFER. See ASSIGN, COM, DIM, INTEGER, 
COMPLEX, and REAL. Unnamed buffers are created in the ASSIGN 
statement by specifying the keyword BUFFER and the number of bytes to be 
reserved for the buffer. See ASSIGN. 

Every buffer has two pointers associated with it. The fill pointer indicates the 
next available location in the buffer for data. The empty pointer indicates the 
next item to be removed from the buffer. This allows an inbound TRANSFER 
and an outbound TRANSFER to access the same buffer simultaneously. 

BDAT and HP-UX files are the only file types allowed in a TRANSFER. An 
end-of-file error will prematurely terminate a TRANSFER, thus triggering an 
end-of-transfer condition. If an end-of-record condition was satisfied when the 
end-of-file was reached, the EOR event will also be true. 

I/O path names should be used to access the contents of the buffer. This 
ensures the automatic updating of the fill and empty pointers during a transfer. 
For named buffers, the contents of the buffer can also be accessed by the 
buffer’s variable name. However, accessing the contents of the buffer by the 
variable name does not update the fill and empty pointers and is likely to 
corrupt the data in the buffer. 

TRANSFER with HFS and SRM Files 

With files on HFS and SRM volumes, the TRANSFER statement runs in 
overlapped mode until the BASIC system encounters a statement that accesses 
the same volume (such as CAT or ASSIGN); at such times, the BASIC system 
performs an implicit WAIT FOR EOT. 

SRM and LIF are not supported for TRANSFER in BASIC/UX. 

Transfer Parameters 

When no parameters are specified for a TRANSFER, an inbound TRANSFER 
will fill the buffer with data and then terminate. An outbound transfer will 
empty the buffer and then terminate. Both inbound and outbound transfers 
execute in overlapped mode when possible. 
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TRANSFER 


The CONT parameter specifies that the TRANSFER is to continue 
indefinitely. Instead of terminating on buffer full or buffer empty conditions, 
the TRANSFER will be temporarily suspended until there is space available in 
the buffer (for inbound transfers) or until there is data available in the buffer 
(for outbound transfers). 

The WAIT parameter specifies that the TRANSFER is to take place serially 
(non-overlapped). Program execution will not leave the TRANSFER statement 
until the data transfer is completed. 

A TRANSFER can be specified to terminate when a device dependent signal 
is received (END), after a specified number of bytes has been transferred 
(COUNT), or after a specific character is detected (DELIM). The DELIM 
parameter can only be used with inbound transfers. 

If END is included on a TRANSFER to a file, the end-of-file pointer is updated 
when the TRANSFER terminates; including EOR(END) causes the end-of-file 
pointer to be updated at the end of each record. 

When the RECORD parameter is specified, the end-of-record parameter must 
also be specified (EOR). The end-of-record condition can be either COUNT, 
DELIM, END or any combination of conditions. 

Overlapped execution of the TRANSFER statement can be deferred until a 
record has been transferred or until the entire TRANSFER has completed. See 
WAIT FOR EOR and WAIT FOR EOT. 


Supported Devices 

The TRANSFER statement supports data transfers to and from the following 
devices. 

HP-IB HP 98624 (and built-in HP-IB on Measurement Coprocessors) 

GPIO HP 98622 

Serial HP 98626 

Datacomm HP 98628 

MUX HP 98642 (BASIC/UX only) 

TRANSFER can also be used with BDAT and HP-UX files on any of the mass 
storage devices or pipes supported by BASIC. 
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Transfer Method (BASIC Workstation only) 

The transfer method is device dependent and chosen by the computer. The 
three possible transfer modes are: 

INT interrupt mode 

FHS fast handshake 

DMA direct memory access 

The DMA mode will be used whenever possible. If the DMA mode cannot be 
used (DMA card is not installed, both channels are busy, DELIM is specified, 
or the interface does not support DMA) then the INT mode will be used. FHS 
is used with the HP-IB or GPIO interfaces only when DMA cannot be used 
and the WAIT parameter is specified. 

Interactions 

When the computer tries to move into the stopped state, it will wait for any 
transfer to complete. Therefore, operations which would cause a stopped 
state will make the computer unresponsive (or “hung”) if a TRANSFER 
is in progress. Operations in this category include a programmed GET, 
modifying a paused program, and STOP. Also, the computer will not exit a j 

context until any TRANSFER in that context is complete. This will cause the 
program to wait at a SUBEXIT, ERROR SUBEXIT, SUBEND, or RETURN 
<expression> statement while a TRANSFER is in progress. If the program is 
paused, but a TRANSFER is still active, the run-light will be an “Io” character 
and the system status Indicator (if present) will say “Transfer.” 

To terminate a transfer before it has finished (and free the computer), execute 
an ABORT 10 (or, as a last resort, press (reset)). 

See also: ASSIGN, WAIT FOR EOT, WAIT FOR EOR, ABORTIO, RESET 
and the “Advanced Transfer Techniques” chapter of the HP BASIC 6.2 
Interface Reference. 
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TRANSFER 


BASIC/UX Specifics 

Either io.burst is used (if specified with CONTROL isc, 255;3) or else DMA 
allocation is managed by the HP-UX kernel and may be used for some or all of 
the TRANSFER segments. 

BASIC/DOS Specifics 

Overlapped transfers on DFS or HPW disks are not supported. Serial transfers 
are not supported for the COM1 or COM2 serial port. 


T 
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TRIGGER 


TRIGGER 


Supported On 
Option Required 
Keyboard Executable 
Programmable 


In an IF ... THEN ... 


UX WS DOS IN 
10 
Yes 
Yes 
Yes 


This statement sends a trigger message to a selected device, or all devices 
addressed to listen, on the HP-IB. 



Item 

Description 

Range 

I/O path name 

name assigned to a device or devices 

any valid name (see 

ASSIGN) 

device selector 

numeric expression, rounded to an 
integer 

(see Glossary) 


Example Statements 

TRIGGER 712 
TRIGGER «Hpib 


Semantics 

The computer must be the active controller to execute this statement. 

If only the interface select code is specified, all devices on that interface which 
are addressed to listen are triggered. If a primary address is given, the bus is 
reconfigured and only the addressed device is triggered. 
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TRIMS 


Supported On 
Option Required 
Keyboard Executable 
Programmable 
In an IF ... THEN ... 


UX WS DOS IN 

None 

Yes 

Yes 

Yes 


This function returns the string stripped of all leading and trailing ASCII 
spaces. 


— C TftIMt X DH 


H2H 


Example Statements 

Unjustify$=TRIM$(" center ") 
Clean$=TRIM$(Input$) 


Semantics 

T 

Only leading and trailing ASCII spaces are removed. Embedded spaces are not 
affected. 

Two-byte Language Specifics 

Certain localized versions of BASIC, such as Japanese localized BASIC, 
support two-byte characters. The TRIMS function does not affect two-byte 
characters, including two-byte blanks. Only CHR$(32) (ASCII space) is 
trimmed from the string. For more information about two-byte characters, 
refer to the globalization chapters of HP BASIC 6.2 Porting and Globalization. 
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TRN 

TON 

See the MAT statement. 
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UNCOMPILE - USING 


UNCOMPILE - USING U-1 


UNCOMPILE 

For details on this command when using the BASIC/DOS, BASIC/WS or 
BASIC/UX, see Compiling HP BASIC 6.2 Programs. 


U-2 UNCOMPILE - USING 


UNL 

UNL 

See the SEND statement. 
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UNLOCK 


Supported On 
Option Required 
Keyboard Executable 
Programmable 


In an IF ... THEN ... 


UX WS DOS 
SRM,DCOMM,or HFS 


Yes 

Yes 

Yes 


This statement is used to remove exclusive access (placed by the LOCK 
statement) on an SRM or HFS file associated with an I/O path name (see 
ASSIGN). 


( UNLOCK 


I/O path 
name 


Item 

Description 

Range 

I/O path name 

name identifying an I/O path to an 
SRM file 

any valid 
Glossary) 

name (see 


Example Statements 

UNLOCK flFile 

IF Done THEN UNLOCK fiFile 

Semantics 

This statement unlocks a file previously locked with the LOCK statement. 
While a file is locked, other SRM workstations or HP-UX processes cannot 
access the file. After UNLOCK, other users may access the file provided they 
possess the proper access capability (or capabilities). 

If multiple LOCKs were executed on the file, the same number of UNLOCKS 
must be executed to unlock the file. 

UNLOCK is performed automatically by SCRATCH A, SCRATCH BIN, 
(reset) and ASSIGN ... TO * (explicit closing of an I/O path). 
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UNLOCK 


BASIC/UX Specifics 

Since LOCK is not available for RFA, NFS or LIF on BASIC/UX, UNLOCK 
is not supported for RFA, NFS or LIF on BASIC/UX. However, no error is 
generated when LOCK or UNLOCK is executed. 

BASIC/DOS Specifics 

BASIC/DOS does not support UNLOCK for DFS files. 
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UNT 


See the SEND statement. 
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UNTIL 


UNTIL 

See the REPEAT ... UNTIL construct. 
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UPC$ 


Supported On 
Option Required 
Keyboard Executable 
Programmable 


In an IF ... THEN ... 


UX WS DOS IN 

None 

Yes 

Yes 

Yes 


This function replaces lowercase ASCII characters with their corresponding 
uppercase characters. 


K2> 


Example Statements 

Capital$=UPC$("lower") 

IF UPC$(Name$)“"TOM" THEN Equal.tom 

Semantics 

The corresponding characters for the Roman Extension alphabetic characters 
are determined by the current lexical order. When the lexical order is a 
user-defined table, the correspondence is determined by the STANDARD 
lexical order. 


Two-byte Language Specifics 

Certain localized versions of BASIC, such as Japanese localized BASIC, 
support two-byte characters. The UPC$ function converts only one-byte 
characters and does not change two-byte characters. For more information 
about two-byte characters, refer to the globalization chapters of the 
HP BASIC 6.2 Porting and Globalization manual. 
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USER KEYS 


USER KEYS 


Supported On 
Option Required 
Keyboard Executable 
Programmable 


In an IF ... THEN ... 


UX WS DOS 

KBD 

Yes 

Yes 

Yes 


This statement changes the softkey definitions on an ITF keyboard to one of 
three User softkey menus. 



Item 

Description 

Range 

menu number 

numeric expression, rounded to an 
integer 

1 through 3 


Example Statements 

USER Menu_number KEYS 
IF Change.keys THEN USER 1 KEYS 

Semantics 

This statement only affects the normal mode of the ITF Keyboard (i.e. it does 
nothing on an HP 98203A/B/C Keyboard and causes no visible change on an 
ITF Keyboard when the Keyboard Compatibility mode is on). 

Note that the functionality of this statement can be achieved through KBD 
CONTROL register 2. 

For information on the softkey definitions, see Using HP BASIC/WS 6.2 or 
Using HP BASIC/UX 6.2. 
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USING 

See the DISP, ENTER, LABEL, OUTPUT, and PRINT statements. 
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VAL - VIEWPORT 


v 
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VAL 


Supported On 
Option Required 
Keyboard Executable 
Programmable 
In an IF ... THEN ... 


UX WS DOS IN 

None 

Yes 

Yes 

Yes 


This function converts an ASCII string expression into a numeric value. 


orgument "HD- 


Item 

Description 

Range 

string argument 

string expression 

numerals, decimal point, 
sign and exponent notation 


Example Statements 

Day=VAL(Date$) 

IF VAL(Response$)<0 THEM Negative 


Semantics 

The first non-blank character in the string must be a digit, a plus or minus 
sign, or a decimal point. The remaining characters may be digits, a decimal 
point, or an E, and must form a valid numeric constant. If an E is present, 
characters to the left of it must form a valid mantissa, and characters to the 
V right must form a valid exponent. The string expression is evaluated when a 
non-numeric character is encountered or the characters are exhausted. 
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VAL 


Two-byte Language Specifics 

Certain localized versions of BASIC, such as Japanese localized BASIC, 
support two-byte characters. The VAL function does not support two-byte 
characters. The string digits to be converted must be one-byte ASCII 
characters. For more information about two-byte characters, refer to the 
globalization chapters of the HP BASIC 6.2 Porting and Globalization manual. 


V 
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VAL$ 


Supported On 
Option Required 
Keyboard Executable 
Programmable 


In an IF ... THEN ... 


UX WS DOS IN 

None 

Yes 

Yes 

Yes 


This function returns an ASCII string representation of the value of the 
argument. The returned string is in the default print format, except that the 
first character is not a blank for positive numbers. No trailing blanks are 
generated. 


KD- 


Item 

Description 

Range 

numeric 

numeric expression 

— 


argument 





Example Statements 

PRINT Esc$;VAL$(Cursor-1) 
Special$=Text$ftVAL$(Number) 
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VIEWPORT 


VIEWPORT 


Supported On 
Option Required 
Keyboard Executable 
Programmable 


In an IF ... THEN ... 


UX WS DOS 

GRAPH 

Yes 

Yes 

Yes 


This statement defines an area onto which WINDOW and SHOW statements 
are mapped. It also sets the soft clip limits to the boundaries it defines. 


(viewport) -! bO-H Sol HoH K^H X, H 


Item 

Description 

Range 

left edge 

numeric expression 

— 

right edge 

numeric expression 

>left edge 

bottom edge 

numeric expression 

— 

top edge 

numeric expression 

>bottom edge 


Example Statements 

VIEWPORT 0,35,50,80 
VIEWPORT Left.Right.Bottom,Top 


Semantics 

The parameters for VIEWPORT are in Graphic Display Units (GDUs). 
Graphic Display Units are 1/100 of the shorter axis of a plotting device. The 
units are isotropic (the same length in X and Y). The soft clip limits are set to 
the area specified, and the units defined by the last WINDOW or SHOW are 
mapped into the area. 
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VIEWPORT 


For the plotter specifier “INTERNAL” (the CRT), the shorter axis is Y. The 
longer axis is X, which is lOOxRATIO GDUs long. For the plotter specifier 
“HPGL” (which deals with devices other than the CRT), the RATIO function 
may be used to determine the ratio of the length of the X axis to the length of 
the Y axis. If the ratio is greater than one, the Y axis is 100 GDUs long, and 
the length of the X axis is 100XRATIO. If the ratio is less than one, then the 
length of the X axis is 100 GDUs and the length of the Y axis is 100xRATIO. 

A value of less than zero for the left edge or bottom is treated as zero. A 
value greater than the hard clip limit is treated as the hard clip limit for the 
right edge and the top. The left edge must be less than the right edge, and the 
bottom must be less than the top, or error 704 results. 
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WAIT 


Supported on 
Option Required 
Keyboard Executable 
Programmable 


In an IF ... THEN ... 


UX WS DOS IN 

None 

Yes 

Yes 

Yes 


This statement will cause the computer to wait approximately the number of 
seconds specified before executing the next statement. Numbers less than 0.001 
do not generate a WAIT interval. 



Item 

Description 

Range 

seconds 

numeric expression, rounded to the 
nearest thousandth 

less than 2 147 483.648 


Example Statements 

WAIT 3 

WAIT 01d_time/2 

BASIC/UX Specifics 

Resolution is limited to 20 milliseconds. Accuracy depends on system load and 
real time priority, but is generally 40 milliseconds. 

BASIC/DOS Specifics 

WAIT periods are generally accurate to within 1 percent, and are system load 
dependent, if running in the background. 

W 
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WAIT FOR EOR 


WAIT FOR EOR 


Supported on 
Option Required 
Keyboard Executable 
Programmable 


In an IF ... THEN ... 


UX WS DOS 

TRANS 

Yes 

Yes 

Yes 


This statement waits until an end-of-record event occurs in the TRANSFER on 
the specified I/O path. 


C 


WAIT FOR EOR 


I/O path 
name 


Item 

Description 

Range 

I/O path name 

name assigned to a device, a group of 
devices, a pipe, or a mass storage file 

any valid name 

Example Statements 


WAIT FOR EOR 

WAIT FOR EOR 

•File 

•Device 



Semantics 

The I/O path may be assigned either to a device, a group of devices, a pipe, 
or to a mass storage file. If the I/O path is assigned to a BUFFER, an error is 
reported when the WAIT FOR EOR statement is executed. 

The WAIT FOR EOR statement prevents further program execution until 
an end-of-record event occurs in the TRANSFER whose I/O path name was 
specified. This allows ON EOR events, which might otherwise be missed, to be 
serviced. If the system priority prevents the servicing of an ON EOR event, the 
event will be logged. 


W 
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The I/O path specified must be involved in an active TRANSFER for the 
statement to have any effect. 
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WAIT FOR EOT 


Supported on 
Option Required 
Keyboard Executable 
Programmable 


In an IF ... THEN ... 


UX WS DOS 

TRANS 

Yes 

Yes 

Yes 


This statement waits until the TRANSFER on the specified I/O path is 
completed. 


C 


WAIT FOR EOT 


I/O path 
name 


Item 

Description 

Range 

I/O path name 

name assigned to a device, a group of 
devices, a pipe, or a mass storage file 

any valid name 

Example Statements 


WAIT FOR EOT 

WAIT FOR EOT 

•File 

•Device 



Semantics 

The I/O path may be assigned either to a device, a group of devices, a pipe, 
or to a mass storage file. If the I/O path is assigned to a BUFFER, an error is 
reported when the WAIT FOR EOT statement is executed. 

The WAIT FOR EOT statement prevents further program execution until 
the specified TRANSFER is completed. This allows ON EOT events, which 
might otherwise be missed, to be serviced. If the system priority prevents the 
servicing of an ON EOT event, the event will be logged. 

The I/O path specified must be involved in an active TRANSFER for the 
statement to have any effect. 


W 
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WHERE 


Supported On 
Option Required 
Keyboard Executable 
Programmable 
In an IF ... THEN 


UX WS DOS 

GRAPHX 

Yes 

Yes 

Yes 


This statement returns the current logical position of the pen and, optionally, 
pen status information. 



Item 

Description 

Range 

x variable name 

name of a numeric variable 

any valid name 

y variable name 

name of a numeric variable 

any valid name 

status variable 

name of a string variable whose 

any valid name 

name 

dimensioned length is at least 3 



Example Statements 

WHERE X,Y 

WHERE X_position,Y_position,Status$ 

Semantics 

The characters in the status string may be interpreted as follows: 
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WHERE 


Byte 

Value 

Meaning 

1 

“0” 

Pen is up 



Pen is down 

2 

comma 

(delimiter) 

3 

“0” 

Current position is outside hard clip 
limits. 



Current position is inside hard clip limits 
but outside viewport boundary. 


“2” 

Current position is inside viewport 
boundary and hard clip limits. 
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WHILE 


Supported On 
Option Required 
Keyboard Executable 
Programmable 


In an IF ... THEN ... 


UX WS DOS IN 

None 

No 

Yes 

No 


This construct defines a loop which is executed as long as the boolean 
expression in the WHILE statement evaluates to true (evaluates to a non-zero 
value). 


boolean 

expression 


program 

segment 


(end whil^-H 


Item 

Description 

Range 

boolean 

expression 

numeric expression; evaluated as true 
if nonzero and false if zero. 

— 

program 

segment 

any number of contiguous program 
lines not containing the beginning 
or end of a main program or 
subprogram, but which may contain 
properly nested construct(s). 



Example Program Segments 

840 WHILE Value<Min OR Value>Max 
850 BEEP 

860 INPUT "Out of range; RE-ENTER".Value 
870 END WHILE 
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WHILE 


1220 WHILE P<»LEN(A$) 

1230 IF NUM(A$[P])<32 THEM 

1240 A$[P]«A$[P+1] ! Remove control codes 

1250 ELSE 

1260 P*P+1 ! Go to next character 
1270 END IF 
1280 END WHILE 

Semantics 

The WHILE ... END WHILE construct allows program execution dependent 
on the outcome of a relational test performed at the start of the loop. If the 
condition is true, the program segment between the WHILE and END WHILE 
statements is executed and a branch is made back to the WHILE statement. 
The program segment will be repeated until the test is false. When the 
relational test is false, the program segment is skipped and execution continues 
with the first program line after the END WHILE statement. 

Branching into a WHILE ... END WHILE construct (via a GOTO) results 
in normal execution up to the END WHILE statement, a branch back to the 
WHILE statement, and then execution as if the construct had been entered 
normally. 

Nesting Constructs Properly 

WHILE ... END WHILE constructs may be nested within other constructs, 
provided the inner construct begins and ends before the outer construct can 
end. 
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WIDTH 

See the PRINTALL IS and PRINTER IS statements. 
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VILDCARDS 


’his statement enables and disables wildcard recognition in file related 
ommands. 


upported On 
)ption Required 
Ceyboard Executable 
‘rogrammable 


n an IF ... THEN ... 


UX WS DOS IN* 

None 

Yes 

Yes 

Yes 



M 


escape 

string 


Item 

Description 

Range 

escape string 

string expression 

any expression that 



evaluates to M, " } or the 



null string 


Example Statements 

WILDCARDS UX;ESCAPE "\" 
WILDCARDS DOS 
WILDCARDS OFF 


Semantics 

Not all implementations of BASIC/IN support WILDCARDS. Refer to 
your instrument programming manual for details. BASIC/IN supports only 
WILDCARDS DOS, while BASIC/WS, BASIC/UX, AND BASIC/DOS 
support both WILDCARDS UX and WILDCARDS DOS. 
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WILDCARDS 


Wildcard recognition is disabled at power-up and after SCRATCH A or 
SCRATCH BIN. To use wildcards, you must explicitly enable them using 
WILDCARDS. 


Caution The effect of the wildcard characters is different for 

WILDCARDS DOS than for WILDCARDS UX. This can 
lead to undesireable consequences, especially with the PURGE 
statement. To determine the current WILDCARDS state, use 
SYSTEM$(“WILDCARDS”). 


Note that you must specify an escape string with WILDCARDS UX. The 
backslash character (“\”) is recommended for HP-UX compatibility. 


Wildcard 

Definitions for WILDCARDS UX 

Meaning 

7 

Matches 0 or 1 characters. For example, X?? matches file names of up 
to 3 characters that begin with the letter X (for example “X”, “Xa”, and 
“Xb”. 

* 

Matches any sequence of 0 or more characters either before or after a 
in a file name. For example, X*Y matches any file names of two or more 
characters that begin with X. Similarly, X*.b* would match “Xabc.bat” 
or “Xyz.bak”. You can use only one asterisk before the period and one 
asterisk after the period to match file names. 

Uist] 

Matches any character specified by list. The list may consist of 
individual characters or a range of characters. The expression 
*[aeiou]* matches any filename containing at least one lower case 
vowel. Ranges are specified using a hyphen. For example, *[0-9]* 
matches any file names containing at least one digit. 

[! list] 

Matches any character not specified by list. Note that the ! must be 
the first character after [ to have the special meaning not; otherwise, 
it is used for matching like any other character. The list contains the 
same types of individual characters and ranges as discussed above. For 
example, * [! 0-9] * matches any file names containing at least one 
non-digit. 


The escape character specified with WILDCARDS UX is used to cancel the 
special meaning of wildcard characters immediately following it within a file 
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WILDCARDS 


name specification. The escape character itself can be used in a file name by 


typing 

it twice. 


100 

WILDCARDS UX ; ESCAPE "\" 


110 

PURGE "file.*" 

deletes files prefixed file. 

120 

PURGE "file_\*" 

deletes file named file.* 

130 

PURGE "file.W" 

deletes file named file_\ 


Wildcards can be used only as the rightmost part of a file specifier. 

/user/smith/my.dir* allowed 

/user/smith/my_dixl/*file allowed 
/user/*/my_dirl/filel not allowed 

/user/smith/*/filel not allowed 


Definitions for WILDCARDS DOS 


Wildcard 

Meaning 

? 

Matches 0 or 1 characters. For example, X?? matches file names of up 
to 3 characters that begin with the letter X (for example “X”, “Xa”, and 
“Xab”). 

* 

Matches any sequence of 0 or more characters either before or after a 
in a file name. For example, X* matches all file names (with null 
extensions) of one or more characters that begin with X. Similarly, 

X*.b* would match “Xabc.bat” or “Xyz.bak”. You can use only one 
asterisk before the period and one asterisk after the period to match file 


names. 


Here is an example program segment using WILDCARDS DOS: 

100 WILDCARDS DOS 

110 PURGE "FILE.*" deletes all files prefixed FILE with no extension 

120 PURGE "*.DAT" deletes all files with .DAT extension 

Wildcards generate matches through file name expansion or file name 
completion. Expansion means that more than one file name can match the 
wildcard specification. Completion means that one and only one file name can 
match the wildcard specification, or an error is generated. 
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Commands Allowing Wildcards 


File Name 
Expansion 

File Name 
Completion 

CAT 

ASSIGN 

PURGE 

DICTIONARY IS 

COPY 

DUMP DEVICE IS 

LINK 

GET 

CHGRP 

GFONT IS 

CHOWN 

LOAD 

LOAD BIN 

LOAD KEY 

PERMIT 

LOAD SUB 

PROTECT 

MSI 

PRINTALL IS 

PRINTER IS 
RENAME 

RE-SAVE 

RE-STORE 

RE-STORE KEY 
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WINDOW 


WINDOW 


Supported On 
Option Required 
Keyboard Executable 
Programmable 


In an IF ... THEN ... 


UX WS DOS 

GRAPH 

Yes 

Yes 

Yes 


This statement is used to define the current-unit-of-measure for graphics 
operations. 


( WINDOW >T €dg« TOT edge ~KM edge VGH 


top 

edge 


Item 

Description 

Range 

left edge 

numeric expression 

— 

right edge 

numeric expression 

^ left edge 

bottom edge 

numeric expression 

— 

top edge 

numeric expression 

^ bottom edge 


Example Statements 

WINDOW -5,5,0,100 

WINDOW Left,Right,Bottom,Top 

Semantics 

WINDOW defines the values represented at the hard clip boundaries, or the 
boundaries defined by the VIEWPORT statement. WINDOW may be used to 
create non-isotropic (not equal in X and Y) units. The direction of an axis 
may be reversed by specifying the left edge greater than the right edge, or the 
bottom edge greater than the top edge. (Also see SHOW.) 
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WINDOW 


For information on scaling with large ranges, when using the WINDOW 
statement, read the section “Special Considerations about Scaling” in the 
chapter “Using Graphics Effectively” found in the HP BASIC 6.2 Programming 
Guide. 


W 
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WORD 

>ee the ASSIGN statement. 


WORD 
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WRITEIO 


Supported On 
Option Required 
Keyboard Executable 
Programmable 


In an IF ... THEN ... 


UX WS DOS* 

None 

Yes 

Yes 

Yes 


This statement writes an integer representation of the register-data parameter 
into the specified hardware register on the specified interface, or into memory. 
The actual action resulting from this operation depends on the interface and 
register (or memory address) selected. 


( WRITEK? ) -»f 


interface 
select code 


HIM 


register 

number 


- /T*\ - register 
data 


Item 

Description 

Range 

select code 

numeric expression, rounded 
to an integer 

1 through 31; —31 through —1; 

±9826; 9827 

register number 

numeric expression, rounded 

—2 31 through +2 31 -1 

or memory 

address 

to an integer 

(hardware-dependent) 

register or 
memory data 

numeric expression, rounded 
to an integer 

—2 31 through ±2 31 -1 


Example Statements 

WRITEIO 12,0;Set_pctl 
WRITEIO Hpib,23;12 
WRITEIO 9826,Mem_addr;Poke_byte 
WRITEIO 9827,Jsr_address;DO_data 

w 
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WRITEIO 


Semantics 

A positive select code (appropriate for most interfaces), writes a byte of data to 
the register, and a negative select code writes a word of data to the register. 

Writing Memory (“Poke”’) 

Using a select code value of 9826 allows you to write directly into memory 
addresses. 

WRITEIO 9826,Mem_address; Data.byte writes a byte of data 

WRITEIO -9826 ,Mem_address; Data.word writes a word of data 

The second parameter specified in the WRITEIO statement is the memory 
address of the byte or word to be written. This parameter is interpreted as a 
decimal address; for instance, an address of 100 000 is 10" 5, not 2"20. The 
third parameter is also interpreted as a decimal number. 

Caution If you write into memory addresses, you risk: 

■ writing into inappropriate RAM locations that can cause the 
software to fail. 

■ writing incorrect values to internal peripheral addresses that 
can cause hardware failure. For example, you should not 
write to addresses corresponding to registers 0 through 9 of 
a CRT controller because doing so will damage some CRT 
hardware. 

In order to avoid these problems, you should only write into 
numeric array variables with WRITEIO. HP cannot be held 
liable for any damages caused by improper use of this feature. 


For a description of the architecture of the computer, see the Pascal System 
Designer’s Guide. This guide consists of three manuals. To order the Pascal 
System Designer’s Guide call your local area HP Sales Representative. 
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Calling Machine-Language Routines 

Using a select code value of 9827 allows you to execute a machine-language 
JSR (“Jump to SubRoutine”) instruction. One parameter must be specified 
in the WRITEIO statement (DO.data in the example below), which will be 
written into the processor’s DO register before the JSR instruction is executed. 
The following program provides a framework for placing a machine-language 
subroutine in an INTEGER array and then jumping to this subroutine. 

10 DATA 

(INTEGER values of machine-language 

20 DATA 

instructions go here.) 


100 INTEGER Int_array(l:100) 

110 READ Int_array(*),DO.data ! Read instructions 
115 ! and DO register data. 

120 Jsr_addr*READI0(9827,Int_array(l)) ! Get JSR address. 

130 WRITEIO 9827,Jsr_addr;D0_data ! Put data in DO, then do JSR. 
140 PRINT "Returned from subroutine." 


BASIC first keeps a copy of processor registers A2 through A6 on the stack. 
Then the value represented by the expression D0_data is placed in the DO 
register, and a machine-language JSR instruction is executed. The value of 
the expression Jsr_addr is the address of an INTEGER array that contains 
machine-language instructions. The value of Jsr.addr is forced to an even 
address before the JSR is executed. 

The last instruction in the subroutine should return control to BASIC with 
a RTS (“ReTurn from Subroutine”) instruction. BASIC will first restore the 
processor registers A2 through A6 (from the stack) to the state they were in 
before the JSR was performed (by the WRITEIO statement). Register A7 
(the stack pointer) must have the same value at the final RTS as it had when 
BASIC executed the JSR. The other processor register can be used freely in 
the assembly routine. BASIC then resumes program execution at the line 
following the WRITEIO statement. 
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WRITEIO 

3ASIC/UX Specifics 

You can write only to your own process’ data space. 

3ASIC/DOS Specifics 

Use of READIO or WRITEIO requires specific knowledge of the Measurement 
Coprocessor hardware. In general, it is recommended that you use STATUS 
ind CONTROL instead. 
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Supported On 
Option Required 
Keyboard Executable 
Programmable 


In an IF ... THEN ... 


UX WS DOS 

XREF 

Yes 

No 

No 


This command allows you to obtain a cross-reference listing of the identifiers in 
a program or subprogram. 
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Item 

Description 

Range 

device selector 

numeric expression; rounded to an 
integer Default = PRINTER IS 
device 

(see Glossary) 

subprogram 

name 

name of a SUB subprogram currently 
in memory 

any valid name 

function name 

name of a user-defined function 
currently in memory 

any valid name 


Example Statements 

XREF 

XREF #705;FNUser$ 

XREF Print 
XREF :NV 

Semantics 

The cross-reference listing is printed one context at a time, in the order that 
they occur in the program. The main program is listed first, followed by the 
subprograms. 

The cross-reference listing starts with this line: 

»» Cross Reference <<<< 

Before each subsequent program segment, this line is printed: 

>»> Subprogram <<<< 

followed by the line number of the first line in that context and the name of the 
context. If the subprogram is a user-defined function, an FN will precede the 
name, and if it is a string function, a $ will follow its name. 
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Within each context, identifiers are listed by type. They occur in the following 
order: 

■ NV—Numeric Variables 

■ SV—String Variables 

■ 10—I/O Path Names 

■ LL—Line Labels 

■ LN—Line Numbers 

■ NF—Numeric Functions 

■ SF—String Functions 

■ SB—SUB Subprograms 

■ CM—Common Block Names 

■ UN—Unused Entries 

If a type is specified in the command, only that type is printed. If there are 
no identifiers of a particular type in the context being cross-referenced, that 
heading is not printed. 

Within each group (which is composed of a header telling what kind of entity 
follows, then the list of those entities), names are alphabetized according to 
the ASCII collating sequence, and line numbers are in numerical order. If a 
reference is a formal parameter in a SUB or DEF FN statement, declared in a 
COM, DIM, REAL, or INTEGER statement, or is a line label, the characters 
<-DEF will be printed immediately to the right of the line number containing 
the defining declaration. Note that variables declared by ALLOCATE are not 
given this marker. If unlabelled (blank) COM is used, it will have no name 
associated with it. 

At the end of each context, a line is printed that begins with: 

Unused entries = 

This is a count of the symbol table entries which have been marked by a 
prerun as “unused.” Unreferenced symbol table locations which have not yet 
been marked “unused” by the prerun processing will show up in the lists of 
identifiers with empty reference lists. Note that a subprogram that is not 
directly recursive will show up in its own cross-reference listing with an empty 
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reference list. (See the “Debugging Programs” chapter of HP BASIC 6.2 
Programming Guide for further details.) 

If a subprogram name or MAIN is specified in the XREF command, the above 
rules are followed, but only the specified subprogram or the MAIN program is 
cross-referenced. If there are two or more subprograms of the same name in the 
computer, they will all be cross-referenced. 

An XREF can be aborted by pressing (reset I , (clr I/O ) or (Break 1 . 
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II 


The following sections contain additional reference information including a 
summary of the keywords by category. 
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Keyword Summary 


The following sections summarize the BASIC keywords by categories. 


Booting BASIC 

LIST BIN Lists binaries currently in memory. 

LOAD BIN Loads a BIN-type file into memory . 
SYSBOOT Returns system control to the boot ROM. 
rmb (HP-UX command) enters BASIC/UX from HP-UX. 


Keyword Summary 
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Program Entry/Editing 

CHANGE Performs search and replace operations on the program in memory. 

COPYLINES Copies program lines from one position to another. 

EDIT Accesses a program using edit mode to enter new program lines or 
modify existing ones. Also used with typing-aid softkeys. 

FIND Searches for a character sequence in a program. 

DEL Deletes specified program lines from memory. 

INDENT Indents a program to reflect its structure. 

LIST Lists program lines or typing-aid softkeys. 

MOVELINES Moves program lines from one position to another. 

REM and ! Allows comments on program lines. 

REN Renumbers programs. 

SECURE Makes program lines unlistable. 
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Program Debugging and Error Handling 

CAUSE ERROR Simulates the occurrence of the BASIC error of the specified 
number. 

CLEAR ERROR Resets most error indicators (ERRN, ERRLN, ERRM$, and 
ERRL) to their power-up state. 

ERRDS Returns the device selector involved in the last I/O error. 

ERRL Indicates whether an error occurred during execution of a specified line. 
ERRLN Returns the program-line number of the most recent error. 

ERRM$ Returns the text of the last error message. 

ERRN Returns the most recent program execution error. 

ERROR RETURN Returns program control to the line following the line which 
caused the most recent GOSUB. Used with ON ERROR GOSUB to avoid 
retrying the line that caused the error (use RETURN to return control to the 
line which caused the error). 

ERROR SUBEXIT Returns program control to the line following the line 
which caused the most recent CALL. Used with ON ERROR CALL to avoid 
retrying the line that caused the error (use SUBEXIT to return control to the 
line which caused the error). 

TRACE ALL Allows tracing of program flow and variable assignments during 
program execution. 

TRACE PAUSE Causes program execution to pause at a specified line. 

TRACE OFF Disables TRACE ALL and TRACE PAUSE. 

XREF Provides a cross-reference to all identifiers used in a program. 
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Memory Allocation and Management 

ALLOCATE Dimensions and allocates memory for arrays or string variables 
during program execution. 

COM Dimensions and reserves memory for variables in a common area for 
access by more than one context. 

COMPLEX Dimensions and reserves memory for complex variables and arrays. 
DEALLOCATE Reclaims memory previously allocated. 

DELSUB Deletes specified subprograms from memory. 

DIM Dimensions and reserves memory for REAL numeric arrays and strings. 

INITIALIZE Creates and deletes RAM mass storage volumes. (See also under 
“Mass Storage.”) 

INMEM Checks for the presence of a user-defined subprogram (SUB) or 
function (FN) in memory. 

INTEGER Dimensions and reserves memory for INTEGER variables and 
arrays. 

LOADSUB Loads BASIC subprograms from a PROG-type file into memory. 

OPTION BASE Specifies the default lower bound for arrays. 

REAL Dimensions and reserves memory for full-precision (REAL) variables 
and arrays. 

SCRATCH Erases selected portions of memory. 
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Comparison Operators 

= Equality. 

< > Inequality. 

< Less than. 

<= Less than or equal to. 

> Greater than. 

>= Greater than or equal to. 
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Math 


General Mattr 

+ Addition operator. 

— Subtraction operator. 

* Multiplication operator. 

/ Division operator. 

Exponentiation operator. 

ABS Returns an argument’s absolute value. 

DIV Divides one argument by another and returns the integer portion of the 
quotient. 

DROUND Returns the value of an expression, rounded to a specified number of 
digits. 

EXP Raises the base e to a specified power. 

FRACT Returns the fractional portion of an expression. 

INT Returns the integer portion of an expression. 

LET Assigns values to variables. 

LGT Returns the log (base 10) of an argument. 

LOG Returns the natural logarithm (base e) of an argument. 

MAX Returns the largest value in a list of arguments. 

MAXREAL Returns the largest number available. 

MIN Returns the smallest value in a list of arguments. 

MINREAL Returns the smallest number available. 

MOD Returns the remainder of integer division. 

MODULO Return the modulo of division. 

PI Returns an approximation of ir. 
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PROUND Returns the value of an expression, rounded to the specified power 
of ten. 

RANDOMIZE Modifies the seed used by the RND function. 

RES Returns last live keyboard numeric result. 

RND Returns a pseudo-random number. 

SGN Returns the sign of an argument. 

SQRT Returns the square root of an argument (same as SQR). 

SQR Returns the square root of an argument (same as SQRT). 

Complex Math 

ARG Returns the argument (or the angle in polar coordinates) of a 
COMPLEX value. 

CMPLX Creates a COMPLEX value, given a real and an imaginary part. 

CONJG Returns the conjugate of a COMPLEX value (negates imaginary 
part). 

IMAG Returns the imaginary part of a COMPLEX value. 

REAL Returns the real part of a COMPLEX value. 

Binary Functions 

BINAND Returns the bit-by-bit logical-and of two arguments. 

BINCMP Returns the bit-by-bit complement of an argument. 

BINEOR Returns the bit-by-bit exclusive-or of two arguments. 

BINIOR Returns the bit-by-bit inclusive-or of two arguments. 

BIT Returns the state of a specified bit of an argument. 

ROTATE Returns a value obtained by shifting an argument’s binary 
representation a number of bit positions, with wrap-around. 

SHIFT Returns a value obtained by shifting an argument’s binary 
representation a number of bit positions, without wrap-around. 
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Trigonometric Operations 

ACS Returns the arccosine of an argument. 

ASN Returns the arcsine of an argument. 

ATN Returns the arctangent of an argument. 

COS Returns the cosine of an angle. 

DEG Sets the degrees mode. 

RAD Sets the radians mode. 

SIN Returns the sine of an angle. 

TAN Returns the tangent of an angle. 

Hyperbolic Operations 

ACSH Returns the hyperbolic arc cosine of a numeric expression. 
ASNH Returns the hyperbolic arcsine of a numeric expression. 
ATNH Returns the hyperbolic arctangent of a numeric expression. 
COSH Returns the hyperbolic cosine of a numeric expression. 
SINH Returns the hyperbolic sine of a numeric expression. 

TANH Returns the hyperbolic tangent of a numeric expression. 
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String Operations 

& Concatenates two string expressions. 

CHR$ Converts a numeric value into one character byte (one ASCII character). 

DVAL Converts an alternate-base representation into a numeric value. 

DVAL$ Converts a numeric value into an alternate-base representation. 

IVAL Converts an alternate-base representation into an INTEGER number. 

IVAL$ Converts an INTEGER into an alternate-base representation. 

LEN Returns the number of bytes (ASCII characters) in a string expression. 

LEXICAL ORDER IS Determines the collating sequence used in ASCII string 
comparisons. 

LWC$ Converts all the ASCII characters in a string to lower case characters. 

MAXLEN Returns the maximum (dimensioned) length of a string variable in 
bytes. 

NUM Returns the decimal value of the first byte (the first ASCII character) in 
a string. 

POS Returns the position of a string within a string expression. 

REVS Reverses the order of the characters in a string expression. 

RPT$ Repeats the characters in a string expression a specified number of 
times. 

TRIMS Removes the leading and trailing ASCII blanks from a string 
expression. 

UPCS Converts all the ASCII characters in a string to upper case characters. 

VAL Converts a string of ASCII digits into a numeric value. 

VALS Returns an ASCII string expression representing a specified numeric 
value. 
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Logical Operators 

AND Returns 1 or 0 based on the logical AND of two arguments. 

EXOR Returns 1 or 0 based on the logical exclusive-or of two arguments. 
NOT Returns 1 or 0 based on the logical complement of an argument. 
OR Returns 1 or 0 based on the logical inclusive-or of two arguments. 
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Mass Storage 

ASSIGN Assigns an I/O path name and attributes to a file. 

CAT Lists the contents of the mass storage media’s directory. 

CHECKREAD Enables or disables read-after-write verification of mass storage 
operations. 

CHGRP Changes the group id of an HFS file or directory. 

CHOWN Changes the ownership of an HFS file or directory. 

COPY Provides a method of copying mass storage files and volumes. 

CREATE Creates an HP-UX-type file on a mass storage media. 

CREATE ASCII Creates an ASCII-type file on a mass storage media. 

CREATE BDAT Creates a BDAT-type file on a mass storage media. 

CREATE DIR Creates a directory on a mass storage media. 

GET Reads an ASCII or HP-UX file into memory as a program. 

INITIALIZE Formats a mass storage media for use with BASIC and places a 
LIF directory on the media. 

LINK Allows the linking of two file names to the same file. 

LOAD Loads a PROG-type file into memory. 

LOAD KEY Loads typing-aid softkey definitions. 

LOADSUB Loads BASIC subprograms from a PROG-type file into memory. 

LOCK Prevents other SRM workstation computers from accessing the file to 
which the specified I/O path is currently assigned. 

MASS STORAGE IS or MSI Specifies the default mass storage device. 

PERMIT Changes the access permission bits on an HFS file or directory. 

PRINT LABEL Writes a string expression to the label of a media. 

PROTECT Specifies a LIF protect code or a password for an SRM file or 
directory. 
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PURGE Deletes a file or directory. 

READ LABEL Reads the label of a media to a string variable. 

RENAME Changes a directory’s name or file’s name and/or path. 

SAVE and RE-SAVE Create an ASCII file and write BASIC program lines as 
strings into the file. RE-SAVE can write to an existing HP-UX file. 

STORE and RE-STORE Create a PROG file and write a BASIC program from 
memory into the file in an internal format. 

STORE KEY and RE-STORE KEY Create a BDAT file and store the 
typing-aid softkey definitions in the file. 

STORE SYSTEM Stores BASIC and all binaries currently in memory in a 
SYSTM file on LIF and SRM. On HFS, it is an HP-UX file. 

UNLOCK Removes exclusive access to an SRM file set by the LOCK 
statement. 

WILDCARDS Enables and disables wildcard recognition within certain file 
related commands. 


1-12 Keyword Summary 


Program Control 

CALL Transfers program execution to a specified subprogram and passes 
parameters. 

CONT Resumes execution of a paused program. 

DEF FN Defines the beginning of a function subprogram. 

FNEND Defines the bounds of a user-defined function subprogram. 

END Terminates program execution and marks the end of the main program 
segment. 

FN Invokes a user-defined function. 

FOR ... NEXT Defines a loop which is repeated a specified number of times. 

GOTO Transfers program execution to a specified line. 

GOSUB Transfers program execution to a specified subroutine. 

IF ... THEN Provides conditional branching. 

ELSE Provides a conditional execution of a program segment. 

LOOP Defines a loop which is repeated until the expression in an EXIT IF 
statement is evaluated as true. 

EXIT IF Provides looping with conditional exit. 

NPAR Returns the number of parameters passed to the current subprogram. 

ON expression Transfers program execution to one of several locations based on 
the value of an expression. 

PAUSE Suspends program execution. 

REPEAT ... UNTIL Allows execution of a program segment until the specified 
condition is true. 

RETURN Transfers program execution from a subroutine to the line following 
the invoking GOSUB. 

RETURN expression Transfers program execution from a user-defined function 
by returning a value to the calling context. 

RUN Starts program execution. 
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SELECT ... CASE Allows execution of one program segment of several. 

STOP Terminates execution of the program. 

SUB Defines the beginning of a SUB subprogram and specifies its formal 
parameters. 

SUBEND Defines the bounds of a subprogram. 

SUBEXIT Transfers control from within a subprogram to the calling context. 

SUSPEND/RESUME INTERACTIVE Allows suspending and resuming 
interactive keyboard operation while a program is running. 

SYSTEMS Returns selected system status and configuration information. 

WAIT Causes program execution to wait a specified number of seconds. 

WAIT FOR EOR Causes program execution to wait for an end-of-record 
during a TRANSFER. 

WAIT FOR EOT Causes program execution to wait for an end-of-transfer. 

WHILE Allows execution of a program segment while the specified condition is 
true. 
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Event-Initiated Branching 

CDIAL Returns information about “control dial” devices. 

DISABLE Disables event-initiated branching (except for ON END, ON 
ERROR, and ON TIMEOUT). 

DISABLE EXT SIGNAL Disable BASIC/UX handling of HP-UX signals. 

DISABLE INTR Disables interrupts defined by the ON INTR statement. 

ENABLE Re-enables all event-initiated branches previously suspended by 
DISABLE. 

ENABLE EXT SIGNAL Enable BASIC/UX handling of HP-UX signals. 

ENABLE INTR Enables the specified interface to generate an interrupt which 
can cause event-initiated branches. 

EXECUTE Execute an HP-UX command from BASIC/UX. 

HILBUFS Returns data sent by an HP-HIL device. 

KBD$ Returns the contents of the ON KBD buffer. 

KNOBX Returns the number of horizontal knob pulses. 

KNOBY Returns the number of vertical knob pulses. 

ON CDIAL Sets up and enables a branch to be taken upon sensing rotation of 
3ne of the dials on a “control dial” device. 

OFF CDIAL Disables any ON CDIAL branching currently set up. 

ON CYCLE Defines and enables an event-initiated branch to be taken each 
time the specified number of seconds has elapsed. 

OFF CYCLE Cancels any event-initiated branches previously defined and 
enabled by an ON CYCLE statement. 

ON DELAY Defines an enables an event-initiated branch to be taken after the 
specified number of seconds has elapsed. 

OFF DELAY Cancels any event-initiated branches previously defined and 
mabled by an ON DELAY statement. 
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ON END Defines and enables an event-initiated branch to be taken when 
end-of-file is reached on the mass storage file associated with the specified I/O 
path. 

OFF END Cancels any event-initiated branches previously defined and enabled 
by an ON END statement. 

ON EOR Defines and enables an event-initiated branch to be taken when an 
end-of-record is encountered during a TRANSFER. 

OFF EOR Cancels any event-initiated branches previously defined and enabled 
by an ON EOR statement. 

ON EOT Defines and enables an event-initiated branch to be taken when the 
last byte is transferred by a TRANSFER statement. 

OFF EOT Cancels any event-initiated branches previously defined and enabled 
by an ON EOT statement. 

ON ERROR Defines and enables an event-initiated branch which results from a 
trappable error. 

OFF ERROR Cancels any event-initiated branches previously defined and 
enabled by an ON ERROR statement. Further errors are reported to the user 
in the usual fashion. 

ON EXT SIGNAL Defines an event-initiated branch to be taken when a system 
generated signal is received. 

OFF EXT SIGNAL Cancels event-initiated branches previously defined by an 
ON EXT SIGNAL statement. 

ON HIL EXT Enables an end-of-line interrupt in response to receiving data 
from HIL devices whose poll records are not otherwise being processed by the 
BASIC system. 

OFF HIL EXT Cancels any event-initiated branches previously defined and 
enabled by an ON HIL EXT statement. 

ON INTR Defines an event-initiated branch to be taken when an interface card 
generates an interrupt. 

OFF INTR Cancels any event-initiated branches previously defined and 
enabled by an ON INTR statement. 
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ON KBD Defines an event-initiated branch to be taken when a key is pressed. 

OFF KBD Cancels any event-initiated branches previously defined and enabled 
by an ON KBD statement. 

ON KEY ... LABEL Defines and enables an event-initiated branch to be taken 
when a softkey is pressed. 

OFF KEY Cancels any event-initiated branches previously defined and enabled 
by an ON KEY statement. 

ON KNOB Defines an event-initiated branch to be taken when the knob is 
turned. 

OFF KNOB Cancels any event-initiated branches previously defined and 
enabled by an ON KNOB statement. Any pending ON KNOB branches 
are lost. Further use of the knob will result in normal scrolling or cursor 
movement. 

ON SIGNAL Defines an event-initiated branch to be taken when a SIGNAL 
statement is executed using the same signal selector. 

OFF SIGNAL Cancels the ON SIGNAL definition with the same signal 
selector. If no signal selector is provided, all ON SIGNAL definitions are 
cancelled. OFF SIGNAL only applies to the current context. 

ON TIME Defines an event-initiated branch to be taken when the clock reaches 
a specified time. 

OFF TIME Cancels any event-initiated branches previously defined and 
enabled by an ON TIME statement. 

ON TIMEOUT Defines an event-initiated branch to be taken when an I/O 
timeout occurs on the specified interface. 

OFF TIMEOUT Cancels any event-initiated branches previously defined and 
enabled by an ON TIMEOUT statement. 

SET HIL MASK Select HIL devices to be used by BASIC/UX processes. 
SIGNAL Generates a software interrupt. 

SYSTEM PRIORITY Sets a minimum level of system priority for 
jvent-initiated branches. 
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HP-HIL Device Support 

HIL SEND Sends HP-HIL commands to HP-HIL devices. 

See also ON/OFF CDIAL, CDIAL, ON/OFF HIL EXT, HILBUFS, ON/OFF 
KNOB, KNOBX, KNOBY, in the preceding “Event-Initiated Branching” 
section. 
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Graphics 

Graphics Control 

ALPHA ON/OFF Turns the alpha planes on or off. 

AREA Selects an area fill color. 

CLIP Redefines a soft-clip area. 

DIGITIZE Inputs the coordinates of a digitized point. 

DUMP GRAPHICS Copies the contents of the graphics display to a printing 
device. 

DUMP DEVICE IS Specifies the device or file for DUMP operations. 

GCLEAR Clears the graphics area. 

GESCAPE Sends and returns device-dependent graphics information. 

GINIT Resets graphics parameters to power-on values. 

GLOAD Loads the graphics display from an INTEGER array. 

GRAPHICS ON/OFF Turns the graphics planes on or off. 

GRAPHICS INPUT IS Specifies the device for digitizing operations. 

GSEND Sends an HPGL command to the current PLOTTER IS device or file. 

GSTORE Copies the contents of the graphics display to an INTEGER array. 

PLOTTER IS Specifies the default plotting device or file. 

RATIO Returns the physical aspect ratio of the plotter’s hard-clip limits. 

READ LOCATOR Samples the locator device, without waiting for a digitize 
signal. 

SET ECHO Specifies the coordinates of an echo on the current plotting device. 
SET LOCATOR Sets the locator position on the input device. 

SET PEN Defines the color of entries in the color map. 

SHOW Defines plotting units that will appear in the VIEWPORT area. 
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TRACK ... ON/OFF Enables and disables locator tracking on the current 
display device. 

VIEWPORT Specifies an area in which WINDOW and SHOW statements are 
mapped. 

WHERE Returns the current logical position of the pen. 

WINDOW Specifies the min and max values for the plotting area specified by 
VIEWPORT. 

Graphics Plotting 

DRAW Draws a line to a specified point. 

ID RAW Draws a line incrementally to a specified point. 

IMOVE Moves the pen incrementally to a specified point. 

IPLOT Draws a line incrementally to the specified point with optional pen 
control. 

LINE TYPE Selects a plotting line type. 

MOVE Moves the pen to a specified point. 

PDIR Specifies rotation for IPLOT, RPLOT, RECTANGLE, POLYGON and 
POLYLINE. 

PEN Selects a plotter pen. 

PENUP Lifts the pen from the plotting surface. 

PIVOT Specifies rotation for lines made with moves, draws, plots, polygons, or 
rectangles. 

PLOT Draws a line to the specified point with optional pen control. 
POLYGON Draws all or part of a closed polygon. 

POLYLINE Draws all or part of an open polygon. 

RECTANGLE Draws a rectangle that can be filled and edged. 

RPLOT Draws a line relative to a movable origin with optional pen control. 
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Graphic Axes and Labeling 

AXES Draws axes with optional tick marks. 

CSIZE Sets the size and aspect ratio for labeled characters. 
FRAME Draws a frame around the current clipping area. 
GRID Draws a full grid pattern for axes. 

LABEL Draws alphanumeric labels. 

LDIR Defines the angle for drawing labels. 

LORG Specifies a labeling location relative to the pen location. 
SYMBOL Allows labeling with user-defined symbols. 
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HP-IB Control 

ABORT Terminates bus activity and asserts IFC. 

CLEAR Places specified devices in a device-dependent state. 

LOCAL Returns specified devices to their local state. 

LOCAL LOCKOUT Sends the LLO message, disabling all device’s front-panel 
controls. 

PASS CONTROL Passes Active Controller capability to another device. 
PPOLL Returns a parallel poll byte from the bus. 

PPOLL CONFIGURE Programs a parallel poll bit for a specified device. 
PPOLL RESPONSE Defines the computers response to a parallel poll. 

PPOLL UNCONFIGURE Disables parallel poll for specified devices. 
REMOTE Sets specified devices to their remote state. 

REQUEST Sends a service request to the Active Controller. 

SEND Sends explicit command and data messages on the bus. 

SPOLL Returns a serial poll byte from a specified device. 

TRIGGER Sends the trigger message to specified devices. 
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Clock and Calendar 

DATE Converts a formatted date into a number of seconds. 

DATES Converts a number of seconds into a formatted date. 

SET TIME Sets the time of day on the real-time clock. 

SET TIMED ATE Sets the time and date on the real-time clock. 

TIME Converts a formatted time of day into a number of seconds past 
midnight. 

TIMES Converts a number of seconds past midnight into a formatted time of 
day. 

TIMED ATE Returns the value of the real-time clock. 

TIMEZONE IS Specifies the clock offset from Greenwich Mean Time (GMT), 
which is used when sharing a disk with an HP-UX system. 
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General Device Input/Output 

ABORTIO Terminates an active TRANSFER. 

ASSIGN Associates an I/O path name and attributes with a device, group of 
devices, mass storage file, or buffer. 

BEEP Produces one of 63 audible tones. 

BREAK Sends a Break signal on a serial interface. 

CONTROL Sends control information to an interface or a table associated with 
an I/O path name. 

CRT Returns the device selector of the CRT. 

DATA Specifies data accessible via READ statements. 

DISP Outputs items to the CRT display line. 

DUMP ALPHA Transfers alpha contents of the CRT to a specified device. 

DUMP DEVICE IS Specifies a device or file for DUMP ALPHA and DUMP 
GRAPHICS operations. 

ENTER Inputs data from a device, file, string, or buffer to a list of variables. 

IMAGE Provides formats for use with ENTER, OUTPUT, DISP, LABEL and 
PRINT operations. 

INPUT Inputs data from the keyboard to a list of variables. 

KBD Returns the device selector of the keyboard. 

LINPUT Inputs literal data from the keyboard to a string variable. 

OUTPUT Outputs items to a specified device, file, string variable, or buffer. 

PRINT Outputs items to the current PRINTER IS device. 

PRINTALL IS Specifies a device for logging messages normally sent to the 
display. 

PRINTER IS Specifies a device for PRINT, CAT, and LIST statements. 

PRT Returns 701, usually the device selector of an external printer. 

READ Inputs data from DATA lists to variables. 
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READIO Reads the contents of the specified hardware registers on the 
specified interface, or reads the contents of the specified memory address. 

RESET Resets an interface or pointers of an I/O path. 

RESTORE Causes a READ statement to access the specified DATA statement. 

SC Returns the interface select code associated with an I/O path. 

SOUND Produces a single tone or multiple tones on the sound generator of an 
HP-HIL interface. 

STATUS Returns the value from a specified interface status register. 

TAB Moves the print position ahead to a specified point; used within PRINT 
and DISP statements. 

TABXY Specifies the print position on the internal CRT; used with PRINT 
statements. 

TRANSFER Initiates unformatted I/O transfers. 

WRITEIO Writes an integer representation of the register data to the specified 
hardware register on the specified interface or to the specified memory address. 
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Display and Keyboard Control 

ALPHA HEIGHT Sets the number of display lines used for alpha output. 

ALPHA PEN Selects the pen number to be used for displaying alpha. 

CHRX Returns the number of pixel columns in an alpha character cell on a 
bit-mapped display. 

CHRY Returns the number of pixel rows in an alpha character cell on a 
bit-mapped display. 

CLEAR LINE Clears the keyboard input line of the display. 

CLEAR SCREEN Clears the display screen. 

CLEAR WINDOW Clear the contents of a BASIC/UX window. 

CLS Clears the display screen. 

CREATE WINDOW Create a window to be accessed by BASIC/UX. 

CRT Returns 1, which is the select code of the CRT display. 

DESTROY WINDOW Delete a window created with CREATE WINDOW. 

DISPLAY FUNCTIONS ON/OFF Enables and disables the “display 
functions” mode. 

KBD Returns 2, which is the select code of the keyboard. 

KBD CMODE Enables and disables the “98203 Keyboard Compatibility 
Mode.” 

KBD LINE PEN Selects the pen number to be used for writing alpha 
characters on the “keyboard input line” and associated display areas. 

KEY LABELS Turns softkey labels on and off. 

KEY LABELS PEN Selects the pen number to be used for displaying softkey 
labels. 

LIST WINDOW List all active BASIC/UX windows and their attributes. 

MERGE ALPHA Joins the “simulated” separate alpha and graphics rasters set 
up by SEPARATE ALPHA FROM GRAPHICS. 

MOVE WINDOW Move a text or graphics window created by BASIC/UX. 
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PRINT PEN Selects the pen number to be used for the output area and 
display line of the alpha display. 

READ KEY Reads typing aid softkey definitions into a string variable. 

RUNLIGHT ON/OFF Turns the run indicator at the bottom right of the 
screen on and off. 

SCRATCH WINDOW Delete all active BASIC/UX windows except the root 
BASIC/UX window. 

SEPARATE ALPHA Simulates the separate alpha and graphics rasters of 
Series 200 displays. 

SET ALPHA MASK Specifies which display planes can be modified by alpha 
display operations. 

SET CHR Re-defines the bit-pattern used by alpha character(s); only available 
on bit-mapped alpha displays. 

SET DISPLAY MASK Specifies which planes of the alpha display are to be 
displayed. 

SET KEY Sets the definition of one or more typing-aid softkeys. 

SYSTEM KEYS Sets the softkey definitions to the System menu (ITF 
keyboards only). 

USER n KEYS Sets the softkey definitions to the specified User menu (ITF 
keyboards only). 

See also CONTROL, DISP, DUMP ALPHA, DUMP DEVICE IS, ENTER, 
IMAGE, INPUT, LINPUT, OUTPUT, PRINT, PRINTALL IS, PRINTER IS, 
STATUS, TAB, and TABXY in the preceding “I/O Operations” section. 
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Array Operations 

BASE Returns the lower bound of a dimension of an array. 

DET Returns the determinant of a matrix. 

DOT Returns the dot product of two vectors. 

MAT Performs various operations on numeric and string arrays. 

MAT REORDER Reorders the elements in an array according to the subscript 
list in a vector. 

MAT SEARCH Searches an array for user-defined conditions. 

MAT SORT Sorts an array along one dimension according to lexical or numeric 
order. 

RANK Returns the number of dimensions in an array. 

REDIM Changes the subscript range of an array. 

SIZE Returns the number of elements in a dimension of an array. 

SUM Returns the sum of all the elements in a numeric array. 


Globalization 

These keywords are used with localized versions of BASIC that support 
languages with two-byte characters, such as Japanese. 

CVT$ Converts strings from one character set to another, such as two-byte 
Japanese Katakana to two-byte Japanese Hiragana. 

DICTIONARY IS Specifies the files that contain user and system dictionaries 
for keyboard input and conversion. 

EXCHANGE Specifies two-byte character code conversions for easy printer 
interfacing. EXCHANGE is a secondary keyword used with ASSIGN, DUMP 
DEVICE IS, PRINTALL IS, and PRINTER IS. 

FBYTE Returns 1 (true) when the first byte in a string is in the valid range for 
the first byte of HP-15 characters. 
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GFONT IS Specifies the file that contains the graphics font characters used by 
LABEL. 

SBYTE Returns 1 (true) when the first byte in a string is in the valid range for 
the second byte of HP-15 characters. 


Other 

BYE Exits BASIC and returns to the operating system. 

EXECUTE Executes an HP-UX or MS-DOS command from BASIC. 
QUIT Exits BASIC and returns to the operating system. 
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Interface Registers 


This section lists the STATUS and CONTROL registers for I/O path names, 
interfaces, and pseudo select code 32. 


I/O Path Registers 

Registers for All I/O Paths 

STATUS Register 0 0 = Invalid I/O path name 

1 = 1/0 path name assigned to a device 

2 = 1/0 path name assigned to a data file 

3 = 1/0 path name assigned to a buffer 

4 = I/O path name assigned to an HP-UX special file 
(See “Interface Registers” in the HP BASIC 6.2 
Interface Reference.) 

I/O Path Names Assigned to a Device 

STATUS Register 1 Interface select code 

STATUS Register 2 Number of devices 

STATUS Register 3 Address of 1st device 

If assigned to more than one device, the addresses of the other devices are 
available starting in STATUS Register 4. 
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I/O Path Names Assigned to an ASCII File 

STATUS Register 1 File type = 3 

STATUS Register 2 Device selector of mass storage device (not 

supported for HFS on BASIC/UX) 

STATUS Register 3 Number of records 

STATUS Register 4 Bytes per record = 256 

STATUS Register 5 Current record 

STATUS Register 6 Current byte within record 

STATUS Register 9 File I/O buffering in use 

CONTROL Register 9 Set file I/O buffer. BASIC/WS allows you to write 

to this register but no action is taken. Writing 
zero (0) enables buffering. Writing one (1) disables 
buffering. 

CONTROL Register 10 In BASIC/DOS, writing a 1 to this register writes 

the pending buffer to the disk file and updates the 
directory entry for the file. However, this command 
has no effect on the buffering mode as defined by 
Control Register 9. 

Note that BASIC/WS and BASIC/UX allow this 
command but perform no action. 

I/O Path Names Assigned to a BDAT File 

STATUS Register 1 File type = 2 

STATUS Register 2 Device selector of mass storage device (not 

supported for HFS on BASIC/UX) 

STATUS Register 3 Number of defined records 

STATUS Register 4 Defined record length 

STATUS Register 5 Current record 

CONTROL Register 5 Set record 
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STATUS Register 6 
CONTROL Register 6 
STATUS Register 7 
CONTROL Register 7 
STATUS Register 8 
CONTROL Register 8 
STATUS Register 9 
CONTROL Register 9 


CONTROL Register 10 


Current byte within record 
Set byte within record 
EOF record 
Set EOF record 
Byte within EOF record 
Set byte within EOF record 
File I/O buffering in use 

Set file I/O buffer. BASIC/WS and BASIC/DOS 
allow you to write to this register but no action is 
taken. Writing zero (0) enables buffering. Writing 
one (1) disables buffering. 

In BASIC/DOS, writing a 1 to this register writes 
the pending buffer to the disk file and updates the 
directory entry for the file. However, this command 
has no effect on the buffering mode as defined by 
Control Register 9. 

Note that BASIC/WS and BASIC/UX allow this 
command but perform no action. 



I/O Path Names Assigned to an HP-UX File 


STATUS Register 1 
STATUS Register 2 

STATUS Register 3 
STATUS Register 4 
STATUS Register 5 
CONTROL Register 5 
STATUS Register 6 
CONTROL Register 6 


File type = 4 

Device selector of mass storage device (not 
supported for HFS on BASIC/UX) 

Number of defined records 

Defined record length (fixed record length = 1) 

Current record 

Set record 

Current byte within record 
Set byte within record 
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STATUS Register 7 EOF record 

CONTROL Register 7 Set EOF record 

STATUS Register 8 Byte within EOF record 

CONTROL Register 8 Set byte within EOF record 
STATUS Register 9 File I/O buffering in use 

CONTROL Register 9 Set file I/O buffer. BASIC/WS allows you to write 

to this register but no action is taken. Writing 
zero (0) enables buffering. Writing one (1) disables 
buffering. 

CONTROL Register 10 In BASIC/DOS, writing a 1 to this register writes 

the pending buffer to the disk file and updates the 
directory entry for the file. However, this command 
has no effect on the buffering mode as defined by 
Control Register 9. 

Note that BASIC/WS and BASIC/UX allow this 
command but perform no action. 

I/O Path Names Assigned to a Buffer 

When the status of register 0 indicates a buffer (3), the status and control 
registers have the following meanings. 

STATUS Register 1 Buffer type (l=named, 2=unnamed) 

STATUS Register 2 Buffer size in bytes 

STATUS Register 3 Current fill pointer 

CONTROL Register 3 Set fill pointer 

STATUS Register 4 Current number of bytes in buffer 

CONTROL Register 4 Set number of bytes 

STATUS Register 5 Current empty pointer 

CONTROL Register 5 Set empty pointer 

STATUS Register 6 Interface select code of inbound TRANSFER 
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STATUS Register 7 
STATUS Register 8 
CONTROL Register 8 

STATUS Register 9 
CONTROL Register 9 

STATUS Register 10 


Interface select code of outbound TRANSFER 

If non-zero, inbound TRANSFER is continuous 

Cancel continuous mode inbound TRANSFER if 
zero 

If non-zero, outbound TRANSFER is continuous 

Cancel continuous mode outbound TRANSFER if 
zero 

Termination status for inbound TRANSFER 



Bit 7 

Bit 6 

Bit 5 

Bit 4 

Bit 3 

Bit 2 

Bit 1 

Bit 0 

0 

TRANS¬ 

FER 

Active 

TRANS¬ 

FER 

Aborted 

TRANS¬ 

FER 

Error 

Device 

Termi¬ 

nation 

Byte 

Count 

Record 

Count 



value=64 

value=32 

value=16 

value=8 

value=4 

value=2 

value=l 


STATUS Register 11 Termination status for outbound TRANSFER 


Bit 7 

Bit 6 

Bit 5 

Bit 4 

Bit 3 

Bit 2 

Bit 1 

Bit 0 

0 

TRANS¬ 

FER 

Active 

TRANS¬ 

FER 

Aborted 

TRANS¬ 

FER 

Error 

Device 

Termi¬ 

nation 

Byte 

Count 

Record 

Count 

0 

2J 

value=64 

value=32 

value=16 

value=8 

value=4 

value=2 

value=0 


STATUS Register 12 Total number of bytes transferred by last inbound 

TRANSFER 


STATUS Register 13 


Total number of bytes transferred by last outbound 
TRANSFER 
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CRT STATUS and CONTROL Registers 

STATUS Register 0 Current print position (column) 

CONTROL Register 0 Set print position (column). See also TAB and 

TABXY. 

STATUS Register 1 Current print position (line) 

CONTROL Register 1 Set print position (line). See also TABXY. 

STATUS Register 2 Insert-character mode 

CONTROL Register 2 Set insert character mode if non-0. Error 713 is 

given if a window number is specified instead of a 
select code on BASIC/UX. 

STATUS Register 3 Number of lines “above screen”. 

CONTROL Register 3 Undefined 

STATUS Register 4 Display functions mode 

CONTROL Register 4 Set display functions mode if non-0. To perform 

the same function, use the statement DISPLAY 
FUNCTIONS ON/OFF. 

STATUS Register 5 Returns the CRT alpha color value set (or default). 

This does not reflect changes due to printing 
CHR$(z), where 136<:r<143. 


2-6 Interface Registers 


2 


CONTROL Register 5 Set default alpha color or gray value 

For Alpha Displays: 


Value 

Result 

< 16 

The number is evaluated 

MOD 8 and resulting values 
produce the following: 

0—black 

1— white 

2— red 

3— yellow 

4— green 

5— cyan 

6— blue 

7— magenta 

16 to 135 

Ignored 

136 

White 

137 

Red 

138 

Yellow 

139 

Green 

140 

Cyan 

141 

Blue 

142 

Magenta 

143 

Black 

144 to 255 

Ignored 


For Bit-Mapped Displays: Values 0 thru 255 which 
correspond to the graphics pens. The values are 
treated as MOD 2~n where n is the number of 
display planes. 

For Gray-Scale Displays: the value corresponds to a 
different intensity of gray. 

CONTROL CRT,5; n sets the values of the CRT 
registers 15, 16, and 17, but the converse is not 
true. That is, STATUS CRT,5 may not accurately 
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reflect the CRT state if CONTROL 15, 16, and/or 

17 have been executed. Note that to perform the 
same function as CONTROL CRT, 5; n, you can use the 
ALPHA PEN statement. 

STATUS Register 6 

ALPHA ON flag. Error 713 is given if a window 
number is specified instead of a select code on 
BASIC/UX. 

CONTROL Register 6 

Undefined. Error 713 is given if a window number 
is specified instead of a select code on BASIC/UX. 

STATUS Register 7 

GRAPHICS ON flag. Error 713 is given if a 
window number is specified instead of a select code 
on BASIC/UX. 

CONTROL Register 7 

Undefined. Error 713 is given if a window number 
is specified instead of a select code on BASIC/UX. 

STATUS Register 8 

Display line position (column) Error 713 is given if 
a window number is specified instead of a select 
code on BASIC/UX. 

CONTROL Register 8 

Set display line position(column). See also TAB. 

Error 713 is given if a window number is specified 
instead of a select code on BASIC/UX. 

STATUS Register 9 

Screenwidth (number of characters). Also available 
in the SYSTEM$(“CRT ID”) function result. 

CONTROL Register 9 

Undefined 

STATUS Register 10 

Cursor-enable flag Error 713 is given if a window 
number is specified instead of a select code on 
BASIC/UX. 
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CONTROL Register 10 


STATUS Register 11 
CONTROL Register 11 

STATUS Register 12 

CONTROL Register 12 


STATUS Register 13 
CONTROL Register 13 
STATUS Register If 


Cursor-enable: 

0 invisible cursor 
non-0=cursor visible. 

Error 713 is given if a window number is specified 
instead of a select code on BASIC/UX. 

CRT character mapping flag 

Disable CRT character mapping (if non-0). This is 
valid only for non-bit-mapped displays. 

Key labels display mode. Error 713 is given if a 
window number is specified instead of a select code 
on BASIC/UX. 

Set key labels display mode: 

0 = typing-aid key labels displayed unless 
program is running. 

1 = key labels always off (or use KEY LABELS 
OFF). 

2 = key labels displayed at all times (or use KEY 
LABELS ON). 

Error 713 is given if a window number is specified 
instead of a select code on BASIC/UX. 

CRT height (number of lines to be used for alpha 
display). 

Set CRT height (must be >= 9). Alternately use 
the ALPHA HEIGHT statement. 

Display replacement rule currently in effect. For 
BASIC/UX information on this register, see the 
HP BASIC 6.2 Interface Reference. 
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CONTROL Register 14 


STATUS Register 15 

CONTROL Register 15 


Set display replacement rule (with bit-mapped 
alpha displays only). For BASIC/UX information 
on this register, see the HP BASIC 6.2 Interface 
Reference. 

This register is not processed for the 9836C display, 
nor for the Model 362/382 internal displays. Any 
updates made to this register are ignored for those 
displays. 


0 

1 

2 

3 

4 

5 

6 

7 

8 

9 

10 
11 
12 

13 

14 

15 


0 

source AND old 
source AND NOT old 
sourcejdefault 
NOT source AND old 
old 

source EXOR old 
source OR old 
source NOR old 
source EXNOR old 
NOT old 

source OR NOT old 
NOT source 
NOT source OR old 
source NAND old 
1 


It is strongly recommended that you do not change 
the default display replacement rule. 

Return the value set (or the default) for the color in 
the PRINT/DISP area. This does not reflect changes 
due to printing CHR$(aO, where 136<£<143. 

Set PRINT/DISP color (or use the PRINT PEN 
statement). Similar to CRT control register 5 but 
specific to CRT PRINT/DISP areas; that is, it does 
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STATUS Register 16 


CONTROL Register 16 


STATUS Register 17 


CONTROL Register 17 


STATUS Register 18 
CONTROL Register 18 


STATUS Register 19 

CONTROL Register 19 
STATUS Register 20 


not affect the areas covered by CRT registers 16 
and 17. 

Return the value set (or the default) for the softkey 
label color. Error 713 is given if a window number 
is specified instead of a select code on BASIC/UX. 

Set key labels color (or use the KEY LABELS PEN 
statement). Similar to CRT control register 5 but 
only affects the softkey labels. Does not affect the 
areas covered by CRT registers 15 and 17. Error 
713 is given if a window number is specified instead 
of a select code on BASIC/UX. 

Return the value set (or the default) for the color 
of the “non-enhance” area. This includes the 
keyboard entry line, runlight, system message line, 
annunciators, and edit screen. 

Set “non-enhance” color (or use the KBD LINE 
PEN statement). This includes the keyboard entry 
line, runlight, system message line, annunciators, 
and edit screen. Similar to CRT control register 
5 but does not affect the areas covered by CRT 
control registers 15 and 16. 

Read the alpha write-enable mask. 

Set alpha write-enable mask to a bit pattern (or 
use the SET ALPHA MASK statement). When 
running BASIC/UX in the X Window environment, 
this CONTROL register is not supported. Error 
713 is given if a window number is specified instead 
of a select code on BASIC/UX. 

Returns the maximum value for the ALPHA MASK 
argument. 

Undefined. 

Read the alpha display-enable mask. Error 713 is 
given if a window number is specified instead of a 
select code on BASIC/UX. 
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CONTROL Register 20 Set alpha display-enable mask to a bit pattern (or 

use the SET DISPLAY MASK statement). When 
running BASIC/UX in the X Window environment, 
this CONTROL register is not supported. Error 
713 is given if a window number is specified instead 
of a select code on BASIC/UX. 

STATUS Register 21 Active CRT binary identity. See CONTROL 

register 21 for a table of CRT binary identification 
codes. 

CONTROL Register 21 Specify which loaded CRT binary BASIC 

will attempt to activate. Each CRT binary is 
represented by one of the following values: 

Value Binary 

0 default search 

1 CRTA 

2 CRTB 

3 reserved 

4 CRTD (single width) 

5 CRTD (double width) 

Note Double wide mode is not supported for 640 by 480 displays. 


If 0 is sent to CONTROL register 21, BASIC 
searches all the loaded binaries in a default order 
and activates the first one found that is compatible 
with the installed hardware. The default search 
order is CRTD, then CRTB, then CRTA. 

Sending a new value to CONTROL register 
21 effectively initializes the alpha display and 
executes GINIT and PLOTTER IS CRT, "INTERNAL". 
BASIC/UX does not support switching between 
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non-bit-mapped and bit-mapped displays, but the 
initialization is still done. 

STATUS Register 22 Undefined (BASIC/UX only). 

CONTROL Register 22 Raises a window to the top of the window stack if 

non-zero; pushes a window to the bottom of the 
stack if zero (BASIC/UX only) 

STATUS Register 23 Returns terminal compatibility mode (BASIC/UX 

only) 

CONTROL Register 23 Sets terminal compatibility mode (BASIC/UX 

only). 



Keyboard STATUS and CONTROL Registers 

STA TUS Register 0 CAPS LOCK flag 

CONTROL Register 0 Set CAPS LOCK if non-0 

STA TUS Register 1 PRINTALL flag 

CONTROL Register 1 Set PRINTALL if non-0 

STATUS Register 2 Function key menu 

CONTROL Register 2 Function key menu: 

0: System menu (or SYSTEM KEYS statement) 

1-3: User menu 1 thru 3 (or USER n KEYS 

statement along with the appropriate menu 
number) 

STATUS Register 3 Undefined 

CONTROL Register 3 Set auto-repeat interval. If 1 thru 255, repeat 

interval in milliseconds is 10 times this value. 256 
= turn off auto-repeat. (Default at power-on or 
SCRATCH A is 30ms.) For BASIC/UX information 
on this register, see the HP BASIC 6.2 Interface 
Reference. 
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STATUS Register 4 
CONTROL Register 4 


STATUS Register 5 

CONTROL Register 5 
STATUS Register 6 

CONTROL Register 6 


Undefined 

Set delay before auto-repeat. If 1 thru 256, delay 
in milliseconds is 10 times this value. (Default 
at power-on or SCRATCH A is 300ms.) For 
BASIC/UX information on this register, see the 
HP BASIC 6.2 Interface Reference. 

KBD$ buffer overflow register, 1 = overflow. 
Register is reset when read. 

Undefined 

Typing aid expansion overflow register, 1 = 
overflow. Register is reset when read. 

Undefined 


STATUS Register 7 Interrupt Status 


Bit 7 

Bit 6 

Bit 5 

Bit 4 

Bit 3 

Bit 2 

Bit 1 

Bit 0 

0 

0 

0 

INITIAL 

Reserved 

Reserved 

RESET 

Keyboard 




-IZE 

For 

For 

Key 

and 




Timeout 

Future 

Future 

Interrupt 

Knob 




Interrupt 

Use 

Use 

Disabled 

Interrupt 




Disabled 




Disabled 

value=128 

value=64 

value=32 

value=16 

value=8 

value=4 

value=2 

value=l 


CONTROL Register 7 Interrupt Disable Mask 


Bit 7 

Bit 6 

Bit 5 

Bit 4 

Bit 3 

Bit 2 

Bit 1 

Bit 0 


Not Used 


INITIAL 

Reserved 

Reserved 

RESET 

Keyboard 




-IZE 

For 

For 

Key 

and Knob 




Timeout 

Future 

Future 







Use 

Use 



value=128 

value=64 

value=32 

value=16 

value=8 

value=4 

value=2 

value=l 
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STATUS Register 8 


Keyboard language jumper 


0-US ASCII 

1- French 

2- German 

3- Swedish 

4- Spanish 

5- Katakana 

6- Canadian English 


7- United Kingdom 

8- Canadian French 

9- Swiss French 

10- Italian 

11- Belgian 

12- Dutch 

13- Swiss German 


14- Latin (Spanish) 

15- Danish 

16- Finnish 

17- Norwegian 

18- Swiss French* 

19- Swiss German* 

20- Kanji (Japanese) 



*See also SYSTEM$(“KEYBOARD LANGUAGE”) which requires the LEX 
binary. Note that the STATUS statement when used with this register does not 
require the LEX binary. 

CONTROL Register 8 Undefined 

STATUS Register 9 Keyboard Type For BASIC/UX information on this 

register, see the HP BASIC 6.2 Interface Reference. 


Bit 7 

Bit 6 

Bit 5 

Bit 4 

Bit 3 

Bit 2 

Bit 1 

Bit 0 

Internal 

Internal 

1=111 L 

l=No 

l=n-Key 

0 

1= 

1= 

Use 

Use 

Keyboard 

Keyboard 

Rollover 






Interface 




Keyboard 

Keyboard 




0=Key- 

0=2 or 






0=non- 

board 

less 






HIL 

Present 

rollover 


Keyboard 

Keyboard 

value=128 

value=64 

value=32 

value=16 

value=8 

value=4 

value=2 

value=l 


Bits 5, 1, and 0 of STATUS Register 9 and the following table can be used to 
determine the Keyboard Type. 
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Bit 5 Bit 1 Bit 0 Keyboard Type 

0 0 0 HP 98203B or built-in 

0 0 1 HP 98203A 

1 0 0 ITF (such as the HP 46020A and 46021A) 

1 1 0 HP 98203C 

CONTROL Register 9 Undefined 

STATUS Register 10 Status at Last Knob Interrupt 


Bit 7 

Bit 6 

Bit 5 

Bit 4 

Bit 3 

Bit 2 

Bit i 

Bit 0 

0 

0 

0 

0 

0 

0 

CTRL 

Key 

Pressed 

SHIFT 

Key 

Pressed 

value=128 

value=64 

value=32 

value=16 

value=8 

value=4 

value=2 

value=l 


Note that bit 1 is always 0 for keyboards connected to an HP-HIL interface, 
and with all HP-HIL mice and knobs (e.g. HP 46083A Rotary Control Knob, 
HP 46085 Control Dials, and HP 98203C Keyboard Knob). 

For BASIC/UX information on this register, see the HP BASIC 6.2 Interface 
Reference. 

CONTROL Register 10 Undefined 

STATUS Register 11 O=horizontal-pulse mode; l=all-pulse mode. 

CONTROL Register 11 Set knob pulse mode (0 is default). See the knob 

discussion in the “Porting to 3.0” chapter of 
HP BASIC 6.2 Porting and Globalization. For 
BASIC/UX information on this register, see the 
HP BASIC 6.2 Interface Reference. 

STATUS Register 12 “Pseudo-EOI for CTRL-E ” flag 

CONTROL Register 12 Enable pseudo-EOI for CTRL-E if non-0 

STATUS Register 13 Katakana flag 


2-16 Interface Registers 





























CONTROL Register 13 
STATUS Register 14 


CONTROL Register 14 
STATUS Register 15 


CONTROL Register 15 


STATUS Register 16 


CONTROL Register 16 


STATUS Register 17 


Set Katakana if non-0 

Numbering of softkeys on ITF keyboard: 

0—QT) is key number 1 (default); 

1—QIJ is key number 0; 

Softkey numbering on ITF keyboard (see STATUS 
Register 14 description) 

Currently in 98203 keyboard compatibility mode: 

0—OFF (default) 

1—ON 

Turns “98203 keyboard compatibility mode” on 
(^0) and off (=0). (See the chapter “Porting to 
Series 300” in the HP BASIC 6.2 Porting and 
Globalization manual for further information about 
using this mode.) Note that instead of using the 
CONTROL register 15 statement you can use 
the KBD CMODE statement to turn the “98203 
keyboard compatibility mode” ON and OFF. 

For BASIC/UX information on this register, see 
Volume 2 of the HP BASIC 6.2 Interface Reference. 

Returns the enabled/disabled status of the up 
and down arrow keys, f Prev 1 , [Next ) , and (&home;l 
(both shifted and un-shifted for all of these keys). 

If the status value is 1 it means these keys are 
deactivated. Note that the default value is 0. 

Allows you to disable or re-enable the display 
scrolling keys mentioned for STATUS Register 
16. This prevents accidental scrolling of the 
display screen. Executing a 1 with the CONTROL 
statement deactivates the print scrolling keys and a 
0 activates them. 

Automatic menu switching: 

1—enabled (default) 

0—disabled 
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CONTROL Register 17 


STATUS Register 24 


CONTROL Register 24 


STATUS Register 25 


CONTROL Register 25 


Automatic menu switching: 

^0—enable 
0—disable 

This register controls whether a system with an ITF 
keyboard will switch to (from) the User 2 Menu 
automatically on entering (leaving) EDIT mode. 

Two-byte character input mode activation status 
(BASIC/WS only). 

0 no two-byte INPUT binary loaded, or 
two-byte input disabled. 

1 two-byte INPUT binary loaded and two-byte 
character input enabled. 

Enables/disables two-byte character input 
(BASIC/WS only). Setting this register has an 
effect only if a two-byte INPUT binary is loaded. 

See STATUS register 24 for details. 

Two-byte character input switch key enable status 
(BASIC/WS only). The two-byte switch key toggles 
the keyboard between one- and two-byte character 
input. 

0 no two-byte INPUT binary loaded or switch 
key disabled. 

1 two-byte INPUT binary loaded and switch key 
enabled. Default after LOAD BIN "INPUT" is 1. 
After INPUT is loaded, SCRATCH A enables the 
switch key. 

Not affected by BASIC reset. 

Enables/disables two-byte switch key (BASIC/WS 
only). Setting this register has an effect only if a 
two-byte INPUT binary is loaded. See STATUS 
register 25 for details. 

0 = switch key disabled 
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1 = switch key enabled 

STATUS and CONTROL Reserved for use with the Japanese INPUT binary. 
Registers 26-28 Refer to the Using Japanese with HP BASIC 

manual for details. 


HP-IB STATUS and CONTROL Registers 


Status Register 0 
Control Register 0 
Status Register 1 


Card identification = 1 
Reset interface if non-zero 
Interrupt and DMA Status 


Bit 7 

Bit 6 

Bit 5 

Bit 4 

Bit 3 

Bit 2 

Bit 1 

Bit 0 

Interrupts 

Enabled 

Interrupt 

Requested 

Hardware 

Interrupt 

Switches 

0 

0 

DMA 
Chan 1 
Enabled 

DMA 
Chan 0 
Enabled 

value=128 

value=64 

value=32 

value=16 

value=8 

value=4 

value=2 

value=l 


Control Register 1 Serial Poll Response Byte 


Bit 7 

Bit 6 

Bit 5 

Bit 4 

Bit 3 

Bit 2 

Bit 1 

Bit 0 

Device 

Dependent 

Status 

SRQ 

1=1 did it 
0=1 didn’t 

Device Dependent Status 

value=128 

value=64 

value=32 

value=16 

value=8 

value=4 

value=2 

value=l 


Status Register 2 Busy Bits 
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Bit 7 

Bit 6 

Bit 5 

Bit 4 

Bit 3 

Bit 2 

Bit 1 

Bit 0 

0 

0 

0 

0 

Reserved 

For 

Future 

Use 

Hand¬ 

shake 

In 

Progress 

Inter¬ 

rupts 

Enabled 

TRANS¬ 
FER In 
Progress 

value=128 

value=64 

value=32 

value=16 

value=8 

value=4 

value=2 

value=l 


Control Register 2 Parallel Poll Response Byte 


Bit 7 

Bit 6 

Bit 5 

Bit 4 

Bit 3 

Bit 2 

Bit 1 

Bit 0 

DI08 

DI07 

DI06 

DI05 

DI04 

DI03 

DI02 

DIOl 

l=True 

l=True 

l=True 

l=True 

l=True 

l=True 

l=True 

l=True 

OO 

CM 

r-H 

II 

0) 

ns 

> 

value=64 

value=32 

value=16 

value=8 

value=4 

value=2 

value=l 

Status Register 3 

Controller Status and Address 



Bit 7 

Bit 6 

Bit 5 

Bit 4 

Bit 3 

Bit 2 

Bit 1 

Bit 0 

System 

Active 

0 

Primary Address of HP-IB Interface 

Controller 

Controller 







value=128 

value=64 

value=32 

value=16 

value=8 

value=4 

value=2 

value=l 


Control Register 3 Set My Address 
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Bit 7 

Bit 6 

Bit 5 

Bit 4 

Bit 3 

Bit 2 

Bit 1 

Bit 0 

Not Used Used 

Primary Address 

value=128 

value=64 

value=32 

value=16 

value=8 

value=4 

value=2 

value=l 
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Status Register 4 


Interrupt Status 



Bit 15 

Bit 14 

Bit 13 

Bit 12 

Bit 11 

Bit 10 

Bit 9 

Bit 8 

Active 

Controller 

Parallel 
Poll Con¬ 
figuration 
Change 

My Talk 
Address 
Received 

My Listen 

Address 

Received 

EOI 

Received 

SPAS 

Remote/ 

Local 

Change 

Talker/ 

Listener 

Address 

Change 

value= 
-32 768 

value= 
16 384 

value= 

8 192 

value= 

4 096 

value= 

2 048 

value= 

1 024 

Value= 

512 

value= 

256 


Bit 7 

Bit 6 

Bit 5 

Bit 4 

Bit 3 

Bit 2 

Bit 1 

Bit 0 

Trigger 

Received 


Unrecog¬ 

nized 

Universal 

Command 

Secondary 

Command 

While 

Addressed 

Clear 

Received 

Unrecog¬ 

nized 

Addressed 

Command 

SRQ 

Received 

IFC 

Received 

value=128 

value=64 

value=32 

value=16 

value=8 

value=4 

value=2 

value=l 


Control Register 4 Writing anything to this register releases NDAC 

holdoff. If non-zero, accept last secondary address 
as valid. If zero, don’t accept last secondary address 
(stay in LPAS or TPAS state). 
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Status Register 5 


Interrupt Enable Mask 


2 


Bit 15 

Bit 14 

Bit 13 

Bit 12 

Bit 11 

Bit 10 

Bit 9 

Bit 8 

Active 

Controller 

Parallel 
Poll Con¬ 
figuration 
Change 

My Talk 

Address 

Received 

My Listen 

Address 

Received 

EOI 

Received 

SPAS 

Remote/ 

Local 

Change 

Talker/ 

Listener 

Address 

Change 

value= 

-32 768 

value= 

16 384 

value= 

8 192 

value= 

4 096 

value= 

2 048 

value= 

1 024 

value= 

512 

value= 

256 


I 


Bit 7 

Bit 6 

Bit 5 

Bit 4 

Bit 3 

Bit 2 

Bit 1 

Bit 0 

Trigger 

Received 

Hand¬ 

shake 

Error 

Unrecog¬ 

nized 

Universal 

Command 

Secondary 

Command 

While 

Addressed 

Clear 

Received 

Unrecog¬ 

nized 

Addressed 

Command 

SRQ 

Received 

IFC 

Received 

value=128 

value=64 

value=32 

value=16 

value=8 

value=4 

value=2 

value=l 


Control Register 5 Parallel Poll Response Mask 


Bit 7 

Bit 6 

Bit 5 

Bit 4 

Bit 3 

Bit 2 

Bit 1 

Bit 0 

m 

Not 

Used 


Uncon¬ 

figure 

Logic 

Sense 

Data Bits Used for Response 

00 

cs 

rH 

II 

4? 

> 

value=64 

value=32 

value=16 

■< 

SL 

sT 

<T> 

II 

OO 

value=4 

value=2 

value=l 
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Status Register 6 


Interface Status 



Bit 15 

Bit 14 

Bit 13 

Bit 12 

Bit 11 

Bit 10 

Bit 9 

Bit 8 

REM 

LLO 

ATN 

True 

LPAS 

TPAS 

LADS 

TADS 

* 

value= 
-32 768 

value= 

16 384 

value= 

8 192 

Value= 

4 096 

Value= 

2 048 

Value= 

1 024 

value= 

512 

Value= 

256 


Bit 7 

Bit 6 

Bit 5 

Bit 4 

Bit 3 

Bit 2 

Bit 1 

Bit 0 

System 

Active 

0 


Primary Address of Interface 


Controller 

Controller 







value=128 

value=64 

value=32 

value=16 

value=8 

value=4 

value=2 

value=l 


* Least-significant bit of last address recognized 
Status Register 7 Bus Control and Data Lines 


Bit 15 

Bit 14 

Bit 13 

Bit 12 

Bit 11 

Bit 10 

Bit 9 

Bit8 

ATN 

DAV 

NDAC 1 

NRFD 1 


SRQ 2 

IFC 

REN 

True 

True 

True 

True 

mm 

True 

True 

True 

value= 

value= 

value= 

value= 

value= 

value= 

value= 

value= 

-32 768 

16 384 

8 192 

4 096 

2 048 

1 024 

512 

256 


Bit 7 

Bit 6 

Bit 5 

Bit 4 

Bit 3 

Bit 2 

Bit 1 

Bit 0 

DI08 

DI07 

DI06 

DI05 

DI04 

DI03 

DI02 

DIOl 

value=128 

value=64 

value=32 

value=16 

value=8 

value=4 

value=2 

value=l 
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1 0nly if currently Addressed to Talk, otherwise not valid. 
2 Only if currently Active Controller, otherwise not valid. 

Interrupt Enable Register (ENABLE INTR) 


Bit 15 

Bit 14 

Bit 13 

Bit 12 

Bit 11 

Bit 10 

Bit 9 

Bit8 

Active 

Controller 

Parallel 
Poll Con¬ 
figuration 
Change 

My Talk 

Address 

Received 

My Listen 

Address 

Received 

EOI 

Received 

SPAS 

Remote/ 

Local 

Change 

Talker/ 

Listener 

Address 

Change 

value= 

-32 768 

value= 

16 384 

value= 

8 192 

value= 

4 096 

value= 

2 048 

value= 

1 024 

value= 

512 

value= 

256 


Bit 7 

Bit 6 

Bit 5 

Bit 4 

Bit 3 

Bit 2 

Bit 1 

Bit 0 

Trigger 

Received 

Hand¬ 

shake 

Error 

Unrecog¬ 

nized 

Universal 

Command 

Secondary 

Command 

While 

Addressed 

Clear 

Received 

Unrecog¬ 

nized 

Addressed 

Command 

SRQ 

Received 

IFC 

Received 

value=128 

value=64 

value=32 

value=16 

value=8 

value=4 

value=2 

value=l 


STATUS Register 255 0: HP-IB interface unlocked and HP-IB interface 

burst I/O disabled 
1: HP-IB interface locked 
3: HP-IB interface burst I/O enabled 

*BASIC/WS and BASIC/DOS accept this 
command but always return the value “3”. 


CONTROL Register 255 


0: disables HP-IB interface locking and HP-IB 
interface burst I/O 
1: enables HP-IB interface locking 
3: enables HP-IB interface burst I/O 
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'BASIC/WS and BASIC/DOS accept this 
command but always set the value to “3”. 


RS-232C Serial 

STATUS and CONTROL Registers 

General Notes: Most Control registers accept values in the range of zero 
through 255. Some registers accept only specified values as indicated, or 
higher values for baud rate settings. Values less than zero are not accepted. 
Higher-order bits not needed by the interface are discarded if the specified 
value exceeds the valid range. 


Reset value is the default value used by the interface after a reset or power-up 
until the value is overridden by a CONTROL statement. 


See the HP BASIC 6.2 Interface Reference for “Modifications to RS-232 and 
Datacomm Registers.” 

STATUS Register 0 Card Identification 

Value returned: 2 indicates a 98626 (if 130 is 
returned, the Remote jumper wire has been 
removed from the interface card); 66 indicates 
a 98644 (194 if the Remote jumper has been 
removed). 

CONTROL Register 0 Interface Reset 


Any value from 1 thru 255 resets the card. 
Execution is immediate; any data transfers in 
process are aborted and any buffered data is 
destroyed. A value of 0 causes no action. 

STATUS Register 1 Interrupt Status 

Bit 7 set: Interface hardware interrupt to CPU 
enabled. 

Bit 6 set: Card is requesting interrupt service. 
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Bits 5&4: 


CONTROL Register 1 


STATUS Register 2 


STATUS Register 3 


CONTROL Register 3 


00 - Interrupt Level 3 
01 - Interrupt Level 4 

10 - Interrupt Level 5 

11 - Interrupt Level 6 
Bits 3 thru 0 not used. 

Transmit BREAK 


Any non-zero value sends a 400 millisecond BREAK 
on the serial line. For BASIC/UX information 
on this register, see the HP BASIC 6.2 Interface 
Reference. 

Interface Activity Status 


Bit 7 thru 3 are not used. 

Bit 2 set: Handshake in progress. This occurs 

only during multi-line function calls. 

Bit 1 set: Firmware interrupts enabled 

(ENABLE INTR active for this select 
code). 

Bit 0 set: TRANSFER in Progress. 


For BASIC/UX information on this register, see the 

HP BASIC 6.2 Interface Reference. 


Current Baud Rate 


Returns one of the values listed under CONTROL 
Register 3. 

Set New Baud Rate 


Use any 

one of the 

following values: 

50 

150 

1200 

4800 

75 

200 

1800 

7200 

no 

300 

2400 

9600 

134 

600 

3600 

19200 

From 25 

to 28800, 

the value will be rounded. Any 


value outside this range gives an error. 
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STATUS Register 4 


Current Character Format 


See CONTROL Register 4 for function of individual 
bits. 

CONTROL Register 4 Set New Character Formats For BASIC/UX 

information on this register, see the HP BASIC 6.2 
Interface Reference. 


Character Format and Parity Settings 


Parity Sense 1 
(Switches 5&4) 

Parity Enable 
(Switch 3) 

Stop Bits 
(Switch 2) 

Character Length 
(Switches 1&0) 

00 ODD parity 

01 EVEN parity 

10 Always ONE 
(BASIC/WS only) 

11 Always ZERO 
(BASIC/WS only) 

0 Disabled 

1 Enabled 

0 1 stop bit 

1 1.5 stop bits 
(if 5 bits/char), 
or 2 stop bits 
(if 6, 7, or 8 
bits/char). 

00 5 bits/char ; 

01 6 bits/char 

10 7 bits/char 

118 bits/char 


1 Parity sense valid only if parity is enabled 
(bit 3=1). If parity is disabled, parity sense is 
meaningless. 

Bits 7 and 6 are reserved for future use. 

STATUS Register 5 Current Status of Modem Control Lines 

Returns CURRENT line state values. See 
CONTROL Register 5 for function of each bit. 

CONTROL Register 5 Set Modem Control Line States 

Sets Modem Control lines or interface state as 
follows: 

Bit 4 set: Enables loopback mode for diagnostic 

tests. 

Bit 3 set: Set Secondary Request-to-Send modem 

line* to active state. 
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Bit 2 set: Set Data Rate Select modem line to 

active state. 

Bit 1 set: Force Request-to-Send modem line to 

fixed active state. 

Bit 1 clear: Toggle RTS line as in normal 
OUTPUT operations. 

Bit 0 set: Force Data Terminal Ready modem 

line to fixed active state. 

Bit 0 clear: Toggle DTR line as in normal 

OUTPUT and ENTER operations. 

*For BASIC/UX information on this register, see the HP BASIC 6.2 Interface 
Reference. 

STATUS Register 6 Data In 

Reads character from input buffer. Buffer contents 
is not destroyed, but bit 0 of STATUS Register 10 
is cleared. 

CONTROL Register 6 Data Out 

Sends character to transmitter holding register. 

This register is sometimes used to transmit protocol 
control characters or other characters without using 
OUTPUT statements. Modem control lines are not 
affected. 

STATUS Register 7 Optional Receiver/Driver Status 

Returns current value of optional circuit drivers or 
receivers as follows: 

Bit 3: Optional Circuit Driver 3 (OCD3). 

Bit 2: Optional Circuit Driver 4 (OCD4). 

Bit 1: Optional Circuit Receiver 2 (OCR2). 

Bit 0: Optional Circuit Receiver 3 (OCR3). 

Other bits are not used (always 0). 

CONTROL Register 7 Set New Optional Driver States 
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STATUS Register 8 


STATUS Register 9 


Sets (bit=l) or clears (bit=0) optional circuit 
drivers as follows: 

Bit 3: Optional Circuit Driver 3 (OCD3), 

Bit 2: Optional Circuit Driver 4 (OCD4). 

Other bits are not used. 

Current Interrupt Enable Mask 

Returns value of interrupt mask associated with 
most recent ENABLE INTR statement. Bit 
functions are as follows: 

Bit 3: Enable interrupt on modem line change. 
STATUS Register 11 shows which modem 
line has changed. 

Bit 2: Enable interrupt on UART status error. 

This has is used to trap ERROR 167 
caused by UART error conditions. STATUS 
Register 10, bits 4 thru 1, show cause of 
error. 

Bit 1: Enable interrupt when Transmitter Holding 
Register is empty (BASIC/WS only). 

Bit 0: Enable interrupt when Receiver Buffer is full 
(BASIC/WS only). 

Cause of Current Interrupt (not supported on 
BASIC/UX) 

Returns cause of interrupt as follows: 

Bits 2&1: Return cause of interrupt 

11 UART error (BREAK, parity, 
framing, or overrun error). See 
STATUS Register 10. 

10 Receiver Buffer full. Cleared 
by STATUS to Register 6 
(BASIC/WS only). 

01 Transmitter Holding Register 
empty. Cleared by CONTROL 
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STATUS Register 10 


STATUS Register 11 


STATUS Register 12 


Register 6 or STATUS to Register 
9 (BASIC/WS only). 

00 Interrupt caused by change 
in modem status line(s). See 
STATUS Register 11. 

Bit 0: Set when no active interrupt requests 

from UART are pending. Clear until 
all pending interrupts have been 
serviced. 

UART Status 

Bit set indicates UART status or detected error as 
follows: 

Bit 7: Not used. 

Bit 6: Transmit Shift Register empty. 

Bit 5: Transmit Holding Register empty. 

Bit 4: Break received. 

Bit 3: Framing error detected. 

Bit 2: Parity error detected. 

Bit 1: Receive Buffer Overrun error. 

Bit 0: Receiver Buffer full. 

Modem Status 

Bit set indicates that the specified modem line or 
condition is active. 

Bit 7: Data Carrier Detect (DCD) modem line 
active. 

Bit 6: Ring Indicator (RI) modem line active, (not 
supported on BASIC/UX) 

Bit 5: Data Set Ready (DSR) modem line active. 
Bit 4: Clear-to-Send (CTS) modem line active. 

Bit 3: Change in DCD line state detected. 

Bit 2: RI modem line changed from true to false. 
Bit 1: Change in DSR line state detected. 

Bit 0: Change in CTS line state detected. 

Modem Handshake Control (not supported on 
BASIC/UX) 
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Bit 7 

Bit 6 

Bit 5 

Bit 4 

Bit 3 

Bit 2 

Bit 1 

Bit 0 

Carrier 

Detect 

Disable 1 

0 

Data Set 

Ready 

Disable 2 

Clear to 

Send 

Disable 3 

0 

0 

0 

0 

value=128 

value=64 

value=32 

value=16 

value=8 

value=4 

value=2 

value=l 


CONTROL Register 12 Modem Handshake Control (not supported on 

BASIC/UX) 


Bit 7 

Bit 6 

Bit 5 

Bit 4 

Bit 3 

Bit 2 

Bit 1 

Bit 0 

Carrier 

Detect 

Disable 1 

Not 

Used 

Data Set 

Ready 

Disable 2 

Clear to 

Send 

Disable 3 

■ 

Not 

Used 

Not 

Used 

m 

value=128 

value=64 

value=32 

value=16 

value=8 

value=4 

value=2 

value=l 


*0 = Wait for Carrier Detect on Enter Operations; 1 = Don’t wait. RMB-UX 
supports bits 7 and 4 in combination only 

2 0 = wait for Data Set Ready on Enter and Output Operations; 1 = Don’t 
wait. BASIC/WS only. 

3 0 = Wait for Clear to Send on Output Operations; 1 = Don’t wait. RMB-UX 
supports bits 7 and 4 in combination only. 
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Interrupt Enable Register (ENABLE INTR) 


2 



STATUS Register 13 Read 98644 “SCRATCH A default” baud rate 1 

Returns the baud rate that will be restored 
whenever SCRATCH A is executed (same 
bit-definitions as STATUS register 3). 

For BASIC/UX information on this register, see the 
HP BASIC 6.2 Interface Reference. 

CONTROL Register 13 Set 98644 “SCRATCH A default” baud rate 1 

Sets both the “current” and the “default” baud 
rate that will be restored whenever SCRATCH A 
is executed (same bit-definitions as CONTROL 
register 3). Default value in this register is 9600 
baud. 

STATUS Register 14 Read 98644 “SCRATCH A default” character 

format 1 

Returns the character format parameters that will 
be restored whenever SCRATCH A is executed 
(same bit-definitions as STATUS register 4). 

J For BASIC/UX information on this register, see the HP BASIC 6.2 Interface 
Reference. 


Interface Registers 2-33 















CONTROL Register 14 Set 98644 “SCRATCH A default” character format 

Sets both the “current” and the “default” character 
format parameters that will be restored whenever 
SCRATCH A is executed (same bit-definitions 
as CONTROL register 4). Default value in 
this register specifies a character format of 8 
bits/character, 1 stop bit, and parity disabled. 


Overview of Datacomm 
Status and Control Registers 

Unless indicated otherwise, the Status Register returns the current value for a 
given parameter; the Control Register sets a new value. 

See the HP BASIC 6.2 Interface Reference for changes to RS-232C and 
Datacomm Registers. 
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Register 

Function 

0 

Control: Interface Reset; Status: Interface Card ID 

1 (Status only) 

Hardware Interrupt Status: l=Enabled, 0=Disabled 

2 (Status only) 

Datacomm activity: 0=inactive, 1=ENTER in process, 

2=OUTPUT in process 1 

3 

Select Protocol: 1= Async, 2= Data Link 1 

4 (Status only) 

Cause of ON INTR program branch 

5 

Control: Terminate transmission; Status: Inbound queue status 

6 

Control: Send BREAK to remote; Status: 1=BREAK pending 

7 (Status only) 

Current modem receiver line states 

8 

Modem driver line states 

9 (Status only) 

Control block TYPE (supported on BASIC/UX) 

10 (Status only) 

Control block MODE (not supported on BASIC/UX) 

11 (Status only) 

Available outbound queue space 

12 

Control: Connect/Disconnect line; Status: Line connection status 
(not supported on BASIC/UX) 

13 

ON INTR mask 

14 

Control Block mask (not supported on BASIC/UX) 

15 

Modem Line interrupt mask 


1 For BASIC/UX information on this register, see the HP BASIC 6.2 Interface 
Reference. 
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Register 

Function 

16 

Connection timeout limit (not supported on BASIC/UX) 

17 

No Activity timeout limit (not supported on BASIC/UX) 

18 

Lost Carrier timeout limit (not supported on BASIC/UX) 

19 

Transmit timeout limit (not supported on BASIC/UX) 

20 

Async: Transmit baud rate (line speed) 

Data Link: Set Transmit/Receive baud rate (line speed) 

21 

Async: Incoming (receiver) baud rate (line speed) (not supported 
on BASIC/UX) 

Data Link: GID address (0 thru 26 corresponds to thru “Z”) 

22 

Async: Protocol handshake type 

Data Link: DID address (0 thru 26 corresponds to thru “Z”) 

23 

Hardware handshake type: ON/OFF, HALF/FULL duplex, 
Modem/Non-modem 

24 

Async: Control Character mask (not supported on BASIC/UX) 
Data Link: Block Size limit 

25 (Status only) 

Number of received errors since last interface reset (not supported 
on BASIC/UX) 

26 

Async: First protocol character (ACK/DC1) 

Data Link: NAKs received since last interface reset 
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For the BASIC Workstation, registers 27-35, 37, and 39 are used with Async 
protocol only. They are not accessible during Data Link operations. Note that 
registers 27-33 and 37-39 are not supported on BASIC/UX and that BASIC/UX 
does not support Data Link operations. 


Register 

Function 

27 

Second protocol handshake character (ENQ/DC3) 

28 

Number of characters in End-of-line sequence 

29 

First character in EOL sequence 

30 

Second character in EOL sequence 

31 

Number of characters in PROMPT sequence 

32 

First character in PROMPT sequence 

33 

Second character in PROMPT sequence 

34 

Data bits per character excluding start, stop and parity 

35 

Stop bits per character (0=1, 1=1.5, and 2=2 stop bits) 

36 

Parity sense: 0=NONE, l=ODD, 2= EVEN, 3=ZERO, 4=ONE 
Data Link: 0=NONE (HP 1000 host), l=ODD (HP 3000 host) 

37 

Inter-character time gap in character times (Async only) 

38 (Status only) 

Transmit queue status (l=empty) 

39 

BREAK time in character times (Async only) 


Datacomm Interface 
Status and Control Registers 

General Notes: Control registers accept values in the range of zero through 
255. Some registers require specified values, as indicated. 
Illegal values or values less than zero or greater than 255, 
cause ERROR 327. 

Reset value, shown for various Control Registers, is the 
default value used by the interface after a reset or power-up 
until the value is overridden by a CONTROL statement. 

Status 0 Card Identification 
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2 

Control 0 

Status 1 

Status 2 


Status 3 
Control 3 

Status 4 


Value returned: 52 (if 180 is returned, check select code switch 
cluster and make sure switch R is ON). 

Card Reset 

Any value, 1 thru 255, resets the card. Immediate execution. 
Data in queues is destroyed. 

Hardware Interrupt Status (not used in most applications) 

1 = Enabled 

0 = Disabled (not supported on BASIC/UX) 

Datacomm Activity 

0 : No activity pending on this select code. 

Bit 0 set: ENTER in progress. 

Bit 1 set: OUTPUT in progress. 

(Non-zero only during multi-line function calls.) 

Current Protocol Identification: 1 = Async, 2 = Data Link. 

Protocol to be used after next card reset (CONTROL Sc,0;l): 1 = 
Async Protocol, 2 = Data Link Protocol (Data Link BASIC/WS 
only). This register overrides default switch configuration. 

Cause of ON INTR program branch. 
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Bit 

Function: Async Protocol 

Function: Data Link Protocol 

0 

Data and/or Control Block available 

Data Block Available 

1 

Prompt received 

Space available for a new transmission 
block 

D 

Framing and/or parity error 

Receive or transmit error 

n 

Modem line change 

Modem line change 

■ 

No Activity timeout (forces a 
disconnect) (BASIC/WS only) 

No Activity timeout (forces a 
disconnect) (BASIC/WS only) 

5 

Lost carrier or connection 
timeout(forces a disconnect) 
(BASIC/WS only) 

Lost carrier or connection 
timeout(forces a disconnect) 
(BASIC/WS only) 

6 

End-of-line received 

Not Used 

7 

Break received 

Not used 


Contents of this register are cleared when a STATUS statement is 
executed to it. 


Interface Registers 2-39 












2 Status 5 Inbound queue status (not supported by BASIC/UX) 



Value 

Interpretation 

0 

Queue is empty 

1 

Queue contains data but no 
control blocks 

2 

Queue contains one or more 
control blocks but no data 
(BASIC/WS only) 

3 

Queue contains both data and 
one or more control blocks 
(BASIC/WS only) 


Control 5 Terminate Transmission (not supported by BASIC/UX) OUTPUT 
S, 5; 0 is equivalent to OUTPUT S; END 

Data Link: Sends previous data as a single block with an ETX 
terminator,then idles the line with an EOT. 

Async: Tells card to turn half-duplex line around. Does 

nothing when line is full duplex. The next data 
OUTPUT automatically regains control of the line by 
raising the RTS (request-to-send) modem line. 

Status 6 Break status: 1 = BREAK transmission pending, 0 = no BREAK 
pending. 

Control 6 Send Break; causes a Break to be sent as follows: 1 

Data Link Protocol: Send Reverse Interrupt (RVI) reply to inbound block, 

instead of data or CN character in next outbound 
block. 

Async Protocol: Transmit Break. Length is defined by Control Register 

39. 

Note that the value sent to the register is arbitrary. 
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1 For BASIC/UX information on this register, see the HP BASIC 6.2 Interface 
Reference. 

Status 7 Modem receiver line states (values shown are for male cable 
connecter option for connection to modems). 

Bit 0: Data Mode (Data Set Ready) line 
Bit 1: Receive ready (Data Carrier Detect line) 

Bit 2: Clear-to-send (CTS) line 

Bit 3: Incoming call (Ring Indicator line) 

Bit 4: 

Status 8 Returns modem driver line states. 

Control 8 Sets modem driver line states (values shown are for male cable 
connector option for connection to modems). 

Bit 0: Request-to-send (RS or RTS) line 1 = line set (active) 

Bit 1: Data Terminal Ready (DTR) line 0 = line clear 

(inactive) 

Bit 2: Driver 1: Data Rate Select bit 

Bit 3: Driver 2: Depends on cable option or adapter used. 

Bit 4: Driver 3: Depends on cable option or adapter used. 

Bit 5: Driver 4: Depends on cable option or adapter used. 

Bit 6,7: Not used. 

Status 9 Returns control block TYPE if last ENTER terminated on a 

control block. See Status Register 10 for values (not supported on 
BASIC/UX). 

Status 10 Returns control block MODE if last ENTER terminated on a 
control block (not supported on BASIC/UX). 
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Async Protocol Control Blocks 


Type 

Mode 

Interpretation 

250 

1 

Break received (Channel A) 

251 

l 1 

Framing error in the following 
character 

251 

2 1 

Parity error in the following 
character 

251 

3 1 

Parity and framing errors in the 
following character 

252 

1 

End-of-line terminator detected 

253 

1 

Prompt received from remote 

0 


No Control Block encountered 


Parity/framing error control blocks are not generated when characters with 
parity and/or framing errors are replaced by an underscore (_) character. 


Data Link Protocol Control Blocks 


Type 

Mode 

Interpretation 

254 

1 

Preceding block terminated by 

ETB character 

254 

2 

Preceding block terminated by 
ETX character 

253 1 

— 

(see following table for Mode 
interpretation) 

0 

0 

No Control Block encountered 


1 


This type is used primarily in specialized applications. 
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Mode Bit(s) 

Interpretation 

0 

1 = Transparent data in following block 

0 = Normal data in following block 

2,1 

00 = Device select 

01 = Group select 

10 = Line select 

3 

1 = Command channel 

2 = Data channel 


Status 11 Returns available outbound queue space (in bytes), provided there 
is sufficient space for at least three control blocks. If not, value is 
zero. 

Status 12 Datacomm Line connection status (not supported on BASIC/UX) 


Value 

Interpretation 

0 

Disconnected 

1 

Attempting Connection 

2 

Dialing 

3 

Connected 2 

4 

Suspended 

5 

Currently receiving data 
(Data Link only) 

6 

Currently transmitting data 
(Data Link only) 


2 When using Data Link: Connected - datacomm idle 


Reset value —0 if R on interface select code switch cluster is ON 

(!)• 
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2 Note 


When the datacomm line is suspended, CLEAR, ABORT, or 
RESET must be executed before the line can be reconnected. 



Control 12 Connects, initiates auto-dial sequence, and disconnects interface 
from datacomm line (not supported on BASIC/UX). 


Value 

Interpretation 

0 

Disconnected from datacomm line 

1 

Connected to datacomm line (set 


DTR k RTS) 

2 

Start auto dial. (Followed by 


OUTPUT of telephone numbers) 


Status 13 Returns current ON INTR mask 
Control 13 Sets ON INTR mask 1 

x If a CONTROL statement is used to access this register, the control block is 
placed in the outbound queue. If the ENABLE INTR ... statement is used 
with a mask, the mask value is placed directly in the control register, bypassing 
any queue delays. 
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Data Link Protocol (BASIC/WS only) 


2 


Bit 

Value 

Enables interrupt when: 

0 

1 

A full block is available in receive 



queue 

1 

2 

Transmit queue is empty 

2 

4 

Receive or transmit error detected 

3 

8 

A modem line changed 

4 

16 2 

No Activity timeout forced a 
disconnection 

5 

32 2 

Lost Carrier or Connection 
timeout caused a disconnection 


2 If bits 4 and 5 are not set, the corresponding errors can be trapped by using 
an ON ERROR statement. 
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Async Protocol 


Bit 

Value 

Enables interrupt when: 

0 

1 

Data or control block available in 
receive queue (BASIC/WS only) 

1 

2 

Prompt received from remote 
device 

2 

4 

Framing or parity error detected in 
incoming data 

3 

8 

A modem line changed 

4 

16 1 

No Activity timeout forced a 
disconnection (BASIC/WS only) 

5 

32 1 

Lost Carrier or Connection 
timeout caused a disconnection 
(BASIC/WS only) 

6 

64 

End-of-line received 

7 

128 

Break received 


Reset value = 0 

1 If bits 4 and 5 are not set, the corresponding errors can be trapped by using 
an ON ERROR statement. 

Status 14 Returns current Control Block mask (not supported on 
BASIC/UX). 

Control 14 Sets Control Block mask. Control block information is queued 
sequentially with incoming data as follows (not supported on 
BASIC/UX). 
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Bit Value Async Control Block Passed 


Prompt position 
2 End-of-line position 
4 Framing and/or Parity error 4 


Data Link Control Block Passed 


Transparent/Normal Mode 2 
ETX Block Terminator 3 
ETB Block Terminator 3 


8 Break received 


Reset Value: 0 (Control Blocks disabled) 6 (ETX/ETB Enabled) 

2 Transparent/Normal format identification control block occurs at the 
beginning of a given block of data in the receive queue. 

3 ETX and ETB Block Termination identification control blocks occur at the 
END of a given block of data in the receive queue. 

4 This control block precedes each character containing a parity or framing 
error. 

Bits 4, 5, 6, and 7 are not used. 

Status 15 Returns current modem line interrupt mask. 

Control 15 Sets modem line interrupt mask. Enables an interrupt to ON 
INTR when Bit 3 of Control Register 13 is set as folows: 
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Status 16 
Control 16 

Status 17 
Control 17 

Status 18 


Bit 

Value 

Modem Line to Cause Interrupt 

0 

1 

Data Mode (Data Set Ready) 

1 

2 

Receive Ready (Data Carrier 
Detect) 

2 

4 

Clear-to-send 

3 

8 

0CR1, Incoming Call (Ring 
Indicator) 

4 

16 

OCR2, Cable or adapter 
dependent 


Reset value= 0 

Note that bit functions are the same as for STATUS register 7. 
Functions shown are for male connector cable option for modem 
connections. 

Returns current connection timeout limit (not supported on 
BASIC/UX). 

Sets Attempted Connection timeout limit. Acceptable values: 

1 thru 255 seconds. 0=timeout disabled (not supported on 
BASIC/UX) 

Reset value=25 seconds 

Returns current No Activity timeout limit (not supported on 
BASIC/UX). 

Sets No Activity timeout limit (not supported on BASIC/UX). 
Acceptable values: 1 thru 255 minutes. 0=timeout disabled. 

Reset Value=10 minutes (disabled if Async, non-modem 
handshake). 

Returns current Lost Carrier timeout limit (not supported on 
BASIC/UX). 
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Control 18 Sets Lost Carrier timeout limit in units of 10 ms. Acceptable 
values: 1 thru 255. 0=timeout disabled. 


Status 19 
Control 19 


Status 20 


Reset Value=40 (400 milliseconds) (not supported on BASIC/UX) 

Returns current Transmit timeout limit (not supported on 
BASIC/UX). 

Sets Transmit timeout limit (loss of clock or CTS not returned 
by modem when transmission is attempted) (not supported on 
BASIC/UX). 

Acceptable values: 1 thru 255.0=timeout disabled. 

Reset Value=10 seconds 

Returns current transmission speed (baud rate). See table for 
values. 


For BASIC/UX information on this register, see the 
HP BASIC 6.2 Interface Reference. 

Control 20 Sets transmission speed (baud rate) as follows: 1 



Register 

Value 

Baud Rate 

Register 

Value 

Baud Rate 

Hgp 

External Clock 

8 

600 


50 


1200 


75 

10 

1800 

1. 

110 

11 

2400 

4* 

134.5 

12 

3600 

5* 

150 

13 

4800 

6* 

200 

14 

9600 

7 

300 

15 

19200 


* Async only. These values cannot be used with Data Link. These values set 
transmit speed ONLY for Async; transmit AND receive speed for Data Link. 
Default value is defined by the interface card configuration switches. 

Status 21 Protocol dependent. Returns receive speed (Async) or GID 
address (Data Link) as specified by Control Register 21. 1 
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Control 21 Protocol dependent. Functions are as follows: 1 

Data Link Protocol: Sets Group IDentifier (GID) for terminal. Values 0 

thru 26 correspond to identifiers A, B, ... Y, Z, 
respectively. Other values cause an error. Default value 
is 1 (“A”). 

Async Protocol: Sets datacomm receiver speed (baud rate). Values and 

defaults are the same as for Control Register 20. 

Status 22 Protocol dependent. Returns DID (Data Link) or protocol 

handshake type (Async) as specified by Control Register 22. 1 

1 For BASIC/UX information on this register, see the HP BASIC 6.2 Interface 

Reference. 

Control 22 Protocol dependent. Functions are as follows: 1 

Data Link Protocol: Sets Device IDentifier (DID) for terminal. Values 

are the same as for Control Register 21. Default is 
determined by interface card configuration switches. 

Async Protocol: Defines protocol handshake type that is to be used. 


Value 

Handshake type 

0 

Protocol handshake disabled 

1 

ENQ/ACK with desktop computer as 
the host (BASIC/WS only - ignored on 
BASIC/UX) 

2 

ENQ/ACK, desktop computer as a 
terminal (BASIC/WS only - ignored on 
BASIC/UX) 

3 

DC1/DC3, desktop computer as host 

4 

DC1/DC3, desktop computer as a 
terminal 

5 

DC1/DC3, desktop computer as both 
host and terminal 
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Status 23 


Control 23 


Status 24 


Control 24 


Returns current hardware handshake type (not supported on 
BASIC/UX). 

Sets hardware handshake type as follows: 

0=Handshake OFF, non-modem connection. 
1=FULL-DUPLEX modem connection. 

2=HALF-DUPLEX modem connection (BASIC/WS only). 
3=Handshake ON, non-modem connection (BASIC/WS 
only). 

Reset Value is determined by interface configuration 
switches. 

Protocol dependent. Returns value set by preceding 
CONTROL statement to Control Register 24 (not supported 
on BASIC/UX). 

Protocol dependent. Functions as follows (not supported on 
BASIC/UX): 


Data Link Protocol: Set outbound block size limit. 



Value 

Block size 

Value 

Block size 

0 

512 bytes 

4 

8 bytes 

1 

2 bytes 



2 

4 bytes 



3 

6 bytes 

255 

510 bytes 


Reset outbound block size limit=512 bytes 

Async Protocol: Set mask for control characters included in receive data 

message queue. 

Bit set: transfer character(s). 

Bit cleared: delete character(s). 
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Bit set 

Value 

Character(s) passed to receive queue 

0 

1 

Handshake characters (ENQ, ACK, DC1, 



DC3) 

1 

2 

Inbound End-of-line character(s) 

2 

4 

Inbound Prompt character(s) 

3 

8 

NUL (CHR$(0)) 

4 

16 

DEL (CHR$(127)) 

5 

32 

CHR$(255) 

6 

64 

Change parity/framing errors to 



underscores (_) if bit is set. 

7 

128 

Not used 


Reset value=127 (bits 0 thru 6 set) 

Status 25 Returns number of received errors since power up or reset (not 
supported on BASIC/UX). 

Note Control Registers 26 through 35, Status Registers 27 through 

35, and Control and Status Registers 37 and 39 are used for 
ASYNC protocol ONLY. They are not available during Data 
Link operation. 


Status 26 Protocol dependent 


Data Link Protocol: Returns number of transmit errors (NAKs received) 
(BASIC/WS only) since last interface reset. 

Async Protocol: Returns first protocol handshake character (ACK or 

DC1). 


Control 26 
(Async only) 
(RMB-UX 
supports only 
17=DC1) 

Status 27 
(Async only) 


Sets first protocol handshake character as follows: 6=ACK, 
17=DC1. Other values used for special applications only. Reset 
value=17 (DC1). Use ACK when Control Register 22 is set to 
1 or 2. Use DC 1 when Control Register 22 is set to 3, 4, or 5. 

Returns second protocol handshake character. 
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Control 27 
(Async only) 
(RMB-UX 
supports only 
19=DC3) 


Sets second protocol handshake character as follows: 5=ENQ, 
19=DC3. Other values used for special applications only. Reset 
value=19 (DC3). Use ENQ when Control Register 22 is set to 
1 or 2. Use DC3 when Control Register 22 is set to 3, 4, or 5. 


Status 28 
(Async only) 

Control 28 
(Async only) 

Status 29 
(Async only) 
Control 29 
(Async only) 

Status 30 
(Async only) 
Control 30 
(Async only) 

Status 31 
(Async only) 

Control 31 
(Async only) 


Status 32 
(Async only) 

Control 32 
(Async only) 

Status 33 
(Async only) 

Control 33 
(Async only) 


Returns number of characters in inbound End-of-line delimiter 
sequence. 

Sets number of characters in End-of-line delimiter sequence 
Acceptable values are 0 (no EOL delimiter), 1, or 2. Reset 
Value—2 

Returns first End-of-line character. 

Sets first End-of-line character. Reset Value=13 (carriage 
return) 

Returns second End-of-line character. 

Sets second End-of-line character. 

Reset Value=10 (line feed) 

Returns number of characters in Prompt sequence. 

Sets number of characters in Prompt sequence. Acceptable 
values are 0 (Prompt disabled), 1 or 2. 

Reset Value=l 

Returns first character in Prompt sequence. 

Sets first character in Prompt sequence. Reset Value=17 
(DCl) 

Returns second character in Prompt sequence. 

Sets second character in Prompt sequence. Reset Value=0 
(null) 
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Returns the number of bits per character. 


Status 34 
(Async only) 

Control 34 Sets the number of bits per character as follows: 1 

(Async only) o=5 bits/character 2=7 bits/character 
1=6 bits/character 3=8 bits/character) 

When 8 bits/char, parity must be NONE, ODD, or EVEN. 
Reset Value is determined by interface card default switches. 

Status 35 Returns the number of stop bits per character. 

(Async only) 

Control 35 Sets the number of stop bits per character as follows:* 

(Async only) 

0=1 stop bit 1=1.5 stop bits 2=2 stop bits 

*Reset Value: 2 stop bits if 150 baud or less, otherwise 1 stop 
bit. Reset Value is determined by interface configuration 
switch settings. 

Status 36 Returns current Parity setting. 

1 For BASIC/UX information on this register, see the HP BASIC 6.2 Interface 
Reference. 
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Control 36 Sets Parity for transmitting and receiving as follows: 1 

Data Link Protocol: 0=NO Parity; Network host is HP 1000 Computer. 

l=ODD Parity; Network host is HP 3000 Computer. 
Reset Value=0 

Async Protocol: 0=NONE; no parity bit is included with any 

characters. 

l=ODD; Parity bit SET if there is an EVEN number 
of “l”s in the character body. 

2=EVEN; Parity bit OFF if there is an ODD number 
of “l”s in the character body. 

3=“0”; Parity bit is always ZERO, but parity is not 
checked (BASIC/WS only). 

4=“1”; Parity bit is always SET, but parity is not 
checked (BASIC/WS only). 

Default is determined by interface configuration switches. If 8 
bits per character, parity must be NONE, ODD, or EVEN. 

Returns inter-character time gap in character times. 

Sets inter-character time gap in character times. Acceptable 
values: 1 thru 255 character times. 0=No gap between 
characters. Reset Value=0 

Status 38 Returns Transmit queue status (not supported on BASIC/UX). 

If returned value=l, queue is empty, and there are no pending 
transmissions. 

Returns current Break time (in character times). 

Sets Break time in character times (not supported on 
BASIC/UX). Acceptable values are: 2 thru 255. Reset 
Value=4. 

L For BASIC/UX information on this register, see the HP BASIC 6.2 Interface 
Reference. 


Status 39 
(Async only) 

Control 39 
(Async only) 


Status 37 
(Async only) 

Control 37 
(Async only) 
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Parallel Interface STATUS and CONTROL Registers 


STATUS Register 0 
CONTROL Register 0 
STATUS Register 1 


Card Identification. 6 is always returned. 

Interface Reset. Any non-zero value causes a reset. 
Interrupt and DMA Status. 


Bit 7 

Bit 6 

Bit 5 

Bit 4 

Bit 3 

Bit 2 

Bit 1 

Bit 0 

Interrupt 

enabled 

Interrupt 

requested 

Interrupt 

level 

Interrupt 

level 

0 

0 

DMA1 

DMAO 

value=128 

value=64 

value=32 

value=16 

value=8 

value=4 

value=2 

value=l 


Bit 7 is set (1) if interrupts are currently enabled. 

Bit 6 is set (1) when the card is currently requesting service. (This bit is 
independent of Interrupt Enabled, bit 7). 

Bits 5 and 4 constitute the card’s hardware interrupt level: 


Bit 5 

Bit 4 

Hardware Interrupt 
Level 

0 

0 

3 

0 

1 

4 

1 

0 

5 

1 

1 

6 


Bits 3 and 2 are not used (always 0). 

Bit 1 is set (1) if DMA channel one is currently enabled. 
Bit 0 is set (1) if DMA channel is currently enabled. 
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On POR (Power on Reset), interrupts are disabled (Bit 7=0) and both DMA 
channels are disabled. The interrupt level reflects the hardware state and is 
always the same. 

STATUS Register 10 Peripheral Status. 


Bit 7 

Bit 6 

Bit 5 

Bit 4 

Bit 3 

Bit 2 

Bit 1 

Bit 0 

0 

0 

0 

0 

0 

nError 

Select 

PError 

value=128 

value=64 

value=32 

value=16 

value=8 

value=4 

value=2 

value=l 


Bits 7-3 
Bit 2 (nError) 
Bit 1 (Select) 
Bit 0 (PError) 


Not used (always 0). 

If this bit is set (1), nError is asserted low. 
If this bit is set (1), Select is asserted high. 
If this bit is set (1), PError is asserted high. 


These bus lines are controlled by the peripheral. This register merely reflects 
the state of these bus lines, and therefore does not have a default POR setting. 


STATUS Register 11 


Communication Status 


Bit 7 

Bit 6 

Bit 5 

Bit 4 

Bit 3 

Bit 2 

Bit 1 

Bit 0 

0 

0 

0 

FIFO 

Full 

FIFO 

Empty 

nStrobe 

Busy 

nAck 

value=128 

value=64 

value=32 

value=16 

value=8 

value=4 

value=2 

value=l 


Bits 7-5 

Bit 4 (FIFO Full 
Bit 3 (FIFO Empty) 
Bit 2 (nStrobe) 

Bit 1 (Busy) 


Not used (always 0). 

If this bit is set (1), the hardware FIFO is full. 

If this bit is set (1), the hardware FIFO is empty. 

If this bit is set (1), nAck is asserted low. 

If this bit is set (1), Busy is asserted high. 
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Bit 0 (nAck) If this bit is set (1), nAck is asserted low. 

On POR the hardware FIFO (first in/first out register) is empty, the nStrobe 
line should not be asserted, and the remaining lines are controlled by the 
peripheral. This register reflects the state of the peripheral owned lines, and 
therefore these register bits do not have a default POR setting. 

STATUS Register 12 Host Line Control 

CONTROL Register 12 Host Line Control 


Bit 7 

Bit 6 

Bit 5 

Bit 4 

Bit 3 

Bit 2 

Bit 1 

Bit 0 

0 

0 

0 

0 

0 

nlnit 

nSelectln 

Wr/nRd 

value=128 

value=64 

value=32 

value=16 

value=8 

value=4 

value=2 

value=l 


Bits 7-3 
Bit 2 (nlnit) 

Bit 1 (nSelectln) 
Bit 0 (Wr/nRd) 


Not used (always 0). 

If this bit is set (1), nlnit is asserted low. 

If this bit is set (1), nSelectln is asserted low. 
If this bit is set (1), Wr/nRd is asserted high. 


On POR, nlnit is asserted low, nSelectln is released high, and Wr/nRd is 
released high. 

STATUS Register 13 I/O Control. 

CONTROL Register 13 I/O Control. 


Bit 7 

Bit 6 

Bit 5 

Bit 4 

Bit 3 

Bit 2 

Bit 1 

Bit 0 

0 

0 

0 

0 

0 

0 

I/O 

Modifier 

Input/ 

nOutput 

value=128 

value=64 

value=32 

value=16 

value=8 

value=4 

value=2 

value=l 


Bits 7-2 Not used (always 0) 
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Bit 1 (I/O Modifier) If cleared, outbound transfers handshake with both 

BUSY and nAck and inbound transfers will use the 
FIFO. If set, outbound transfers will handshake 
with BUSY only and inbound transfers will only use 
one location in the FIFO (FIFO disabled). 

Bit 0 (Input/nOutput) If this bit is set to 1, Input is selected. If this bit is 

reset (0), output is selected. 

On POR bits 1 and 0 are reset to 0. 

STA TUS Register 14 FIFO 

CONTROL Register 14 FIFO 

In order to get valid information when reading the hardware FIFO, the I/O 
direction must be “input” and the FIFO must not be empty (see the Hardware 
I/O Status and Control register and the Communication Status register). If 
either of these conditions are not true, reading this register will not cause an 
error, but unpredictable results may occur. 

For writing, the same rules apply. The I/O direction must be “output” and the 
FIFO must not be full. If either of these conditions are not true, writing this 
register will not cause an error, but the data written will not be entered into 
the hardware FIFO. 



Note This register should not be used unless the program has full 

control of this select code. For example, if this register is being 
used while the driver is attempting a transfer, it is very likely 
the transfer will fail. 


STATUS Register 20 Peripheral Type 
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Decimal 

value 

Peripheral type 

0 

No device attached. 

1 

Output-only, device is currently attached. 

2 

An HP bidirectional device is attached. 

10 

User-specified no device. 

11 

User-specified output only device. 

12 

User-specified HP bidirectional device. 


CONTROL Register 20 Peripheral Type 


Decimal 

value 

Peripheral type 

0 

No device attached. 

10 

User-specified no device. 

11 

User-specified output only device. 

12 

User-specified HP bidirectional device. 


I/O initialize resets peripheral. 

CONTROL Register 22 Peripheral Reset 

Writing any non-zero value to this register causes the driver to attempt a 
hardware soft reset on the attached peripheral. The driver will assert the nlnit 
line, wait, release the nlnit line, and wait for Busy to be released. 

STATUS Register 23 Interrupt State 
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Bit 7 

Bit 6 

Bit 5 

Bit 4 

Bit 3 

Bit 2 

Bit 1 

Bit 0 

FIFO 

Full 

FIFO 

Empty 

0 

Busy 

nAck 

nError 

Select 

P Error 

value=128 

value=64 

value=32 

value=16 

value=8 

value=4 

value=2 

value=l 


This register returns the interrupt requests that are currently being made by 
the driver. 

Bit 7 (FIFO Full) 

If this bit is set (1), an interrupt will be requested 
when the hardware FIFO transitions to full. 

Bit 6 (FIFO Empty) 

If this bit is set (1), an interrupt will be requested 
when the hardware FIFO transitions to empty. 

Bit 5 (Busy) 

Not used (always 0). 

Bit 4 (Busy) 

If this bit is set (1), an interrupt will be requested 
when the Busy signal is low. 

Bit 3 (nAck) 

If this bit is set (1), an interrupt will be requested 
when the nAck signal transitions low. 

Bit 2 (nError) 

If this bit is set (1), an interrupt will be requested 
when the nError signal transitions. 

Bit 1 (Select) 

If this bit is set (1), an interrupt will be requested 
when the Select signal transitions. 

Bit 0 (PError) 

If this bit is set (1), an interrupt will be requested 
when the PError signal transitions. 

On POR the driver disables all interrupt conditions, thus this register will 
return a 0 on POR. 

STATUS Register 24 

Driver Options 

CONTROL Register 24 

Driver Options 
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Bit 7 

Bit 6 

Bit 5 

Bit 4 

Bit 3 

Bit 2 

Bit 1 

Bit 0 

0 

0 

0 

0 

Ignore 

PError 

Write 

Verify 

Wr/nRd 

low 

Use nAck 

value=128 

II 

<u 

value=32 

value=16 

value=8 

value=4 

value=2 

value=l 


Bits 7-4 

Bit 3 (Ignore PError) 


Bit 2 (Write Verify) 


Bit 1 (Wr/nRd low) 


Bit 0 (Use nAck) 


STATUS Register 26 


Not used (always 0). 

If this bit is set to 1, the interface will communicate 
with the device despite PError assertion. 

If this bit is set to 0 (the default), an error occurs 
on a communication attempt with PError asserted. 

If this bit is set to 1, the interface verifies that the 
peripheral receives data on each byte sent. 

If this bit is set to 0 (the default), verification does 
not occur. 

If this bit is set to 1, Wr/nRd is always LOW. 

If this bit is set to 0 (the default), Wr/nRd HIGH 
on ouput, LOW on input. 

If this bit is set to 1, the interface uses nAck to 
complete the output handshake. 

If this bit is set to 0 (the default), the interface uses 
Busy to complete the output handshake. 

Driver State 


Bit 7 

Bit 6 

Bit 5 

Bit 4 

Bit 3 

Bit 2 

Bit 1 

Bit 0 

Disable 
by user 

Inactive 

ERROR 

Write 

Read 

0 

0 

0 


value=128 

value=64 

value=32 

value=16 

value=8 

value=4 

value=2 

value=l 
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The driver states are: 

DISABLED _BY_U SER 

INACTIVE-ERROR 

INACTIVE-WRITE 

ACTIVE-WRITE 

INACTIVE-READ 

ACTIVE-READ 


=80h (hexidecimal) 

=40h 

=20h 

=21h 

=10h 

=llh 


If the POR state of the peripheral type is not “user specified no device” (see 
register 20) then the POR state for this register is INACTIVE-ERROR. 
Otherwise, the POR state is DISABLED_BY_USER. 


GPIO STATUS and CONTROL Registers 


STATUS Register 0 Card Identification. Always 3. 

CONTROL Register 0 Interface Reset. Any non-zero value causes a reset. 


Bit 7 

Bit 6 

Bit 5 

Bit 4 

Bit 3 

Bit 2 

Bit 1 

Bit 0 

Interrupts 

An Inter- 

Interrupt 


Burst- 

Word- 

DMA 

DMA 

Are 

rupt Is 

Level Switches 


Mode 

Chan 1 

Chan 0 

Enabled 

Currently 

Requested 

(HardwarePriority) 

DMA 

DMA 

Enabled 

Enabled 

value=128 

value=64 

value=32 

value=16 

value=8 

value=4 

value=2 

value=l 


CONTROL Register 1 Set PCTL Line. Any non-zero value sets the line. 
STATUS Register 2 


Interface Registers 2-63 


























Bit 7 

Bit 6 

Bit 5 

Bit 4 

Bit 3 

Bit 2 

Bit 1 

Bit 0 

0 

0 

0 

0 

0 

Hand¬ 

shake 

In 

Process 

Interrupts 

Are 

Enabled 

Transfer 

In 

Progress 

value=128 

value=64 

value=32 

% 

II 

h— 1 

O 

value=8 

value=4 

value=2 

value=l 
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CONTROL Register 2 Peripheral Control 


Bit 7 

Bit 6 

Bit 5 

Bit 4 

Bit 3 

Bit 2 

Bit 1 

Bit 0 

Not used 

PSTS 
Error 
l=Report 
0=Ignore 

Set 

CTL1 

l=Low 

0=High 

Set 

CTLO 

l=Low 

0=High 

value=128 

value=64 

value=32 

value=16 

value=8 

value=4 

value=2 

value=l 


STATUS Register 3 
CONTROL Register 3 
STATUS Register 4 

STATUS Register 5 


Data In (16 bits) 

Data Out (16 bits) 

Interface Ready. Interface is Ready for a subsequent 
data transfer: l=Ready, 0=Busy. 

Peripheral Status 


Bit 7 

Bit 6 

Bit 5 

Bit 4 

Bit 3 

Bit 2 

Bit 1 

Bit 0 

0 

0 

0 

0 

PSTS 

Ok 

EIR 

Line Low 

STI1 

Line Low 

STIO 

Line Low 

value=128 

value=64 

value=32 

value=16 

value=8 

value=4 

value=2 

value=l 
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Interrupt Enable Register 


(ENABLE INTR) 


Bit 7 

Bit 6 

Bit 5 

Bit 4 

Bit 3 

Bit 2 

Bit 1 

Bit 0 

Not used 

Not used 

Not used 

Not used 


Not used 

Enable 

Interface 

Ready 

Interrupt 

Enable 

EIR 

Interrupt 

value=128 

value=64 

value=32 

value=16 

value=8 

value=4 

value=2 

value=l 


STATUS Register 255 0: GPIO interface unlocked and GPIO interface 

burst I/O disabled 
1: GPIO interface locked 
3: GPIO interface burst I/O enabled 

*BASIC/WS and BASIC/DOS accept this 
command but always return the value “3”. 


CONTROL Register 255 0: disables GPIO interface locking and GPIO 

interface burst I/O* 

1: enables GPIO interface locking 
3: enables GPIO interface burst I/O 

*BASIC/WS and BASIC/DOS accept this 
command but always set the value to “3”. 


BCD 

STATUS and CONTROL Registers 


Note This section does not apply to BASIC/UX. 


STATUS Register 0 Card Identification = 4. 

CONTROL Register 0 Reset Interface (if non-zero value sent). 
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STATUS Register 1 


Interrupt Status 


2 


Bit 7 

Bit 6 

Bit 5 

Bit 4 

Bit 3 

Bit 2 

Bit 1 

Bit 0 

Interrupts 

are 

enabled 

Interrupt 

Request 

Hardware Interrupt 
Level Switches 

0 

0 

0 

0 

value=128 

value=64 

value=32 

value=16 

value=0 

value=0 

value=0 

value=0 



CONTROL Register 1 Reset driver pointer (if non-zero value sent). 
STATUS Register 2 Busy Bit 


Bit 7 

Bit 6 

Bit 5 

Bit 4 

Bit 3 

Bit 2 

Bit 1 

Bit 0 

0 

0 

0 

0 

0 

Hand¬ 
shake in 
progress 

Interrupts 

Enabled 

0 

value=128 

value=64 

value=32 

value=16 

value=8 

value=4 

value=2 

value= 1 


Bit 0 is 1 when a handshake is currently in progress. 


CONTROL Register 2 


STATUS Register 3 
CONTROL Register 3 


STATUS Register 4 


Request data by Setting CTLA and CTLB (if a 
non-zero value is sent); this operation also clears an 
Interrupt Request (clears bit 6 of Status Register 

i). 

Binary Mode: 1 if the interface is currently 
operating in Binary mode, and 0 if in BCD mode. 

Set Binary Mode: set Binary Mode if non-zero 
value sent, and BCD Mode if zero sent. 

Switch and Line States 
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2 


Bit 7 

Bit 6 

Bit 5 

Bit 4 

Bit 3 

Bit 2 

Bit 1 

Bit 0 

OF 

DATA 

SGN1 

SGN2 

OVLD 

SGN1 

SGN2 

OVLD 

Switch 

Switch Is 

Switch Is 

Switch Is 

Switch 

Input 

Input 

Input 

Is ON 

ON 

ON 

ON 

Is ON 

Is True 

Is True 

Is True 

value=128 

value=64 

value=32 

value=16 

value=8 

value=4 

value=2 

value=l 


CONTROL Register 4 Data Out Lines 


Bit 7 

Bit 6 

Bit 5 

Bit 4 

Bit 3 

Bit 2 

Bit 1 

Bit 0 

Set 

Set DO-6 

Set DO-5 

Set DO-4 

Set 

Set 

Set 

Set 

DO-7 

True 

True 

True 

DO-3 

DO-2 

DO-1 

DO-O 

True 




True 

True 

True 

True 

value=128 

value=64 

value=32 

value=16 

value=8 

value=4 

value=2 

value=l 
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STATUS Register 5 


BCD Digits Dll and DI2 


2 


Bit 7 

Bit 6 

Bit 5 

Bit 4 

Bit 3 

Bit 2 

Bit 1 

Bit 0 

Dll-8 

is 

True 

Dll-4 is 
True 

Dll-2 is 
True 

Dll-1 is 
True 

DI2-8 

is 

True 

DI2-4 

is 

True 

DI2-2 

is 

True 

DI2-1 

is 

True 

value=128 

value=64 

value=32 

value=16 

value=8 

value=4 

value=2 

value=l 


STATUS Register 6 BCD Digits DI3 and DI4 


Bit 7 

Bit 6 

Bit 5 

Bit 4 

Bit 3 

Bit 2 

Bit 1 

Bit 0 

DI3-8 

is 

True 

DI3-4 is 
True 

DI3-2 is 
True 

DI3-1 is 
True 

DI4-8 

is 

True 

DI4-4 

is 

True 

DI4-2 

is 

True 

DI4-1 

is 

True 

value=128 

value=64 

value=32 

value=16 

value=8 

value=4 

value=2 

value=l 


STATUS Register 7 BCD Digits DI5 and DI6 


Bit 7 

Bit 6 

Bit 5 

Bit 4 

Bit 3 

Bit 2 

Bit 1 

Bit 0 

DI5-8 

is 

True 

DI5-4 is 
True 

DI5-2 is 
True 

DI5-1 is 
True 

DI6-8 

is 

True 

DI6-4 

is 

True 

DI6-2 

is 

True 

DI6-1 

is 

True 

value=128 

value=64 

value=32 

value=16 

value=8 

value=4 

value=2 

value=l 


STATUS Register 8 BCD Digits DI7 and DI8 
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2 


Bit 7 

Bit 6 

Bit 5 

Bit 4 

Bit 3 

Bit 2 

Bit 1 

Bit 0 

DI7-8 

is 

True 

DI7-4 is 
True 

DI7-2 is 
True 

DI7-1 is 
True 

DI8-8 

is 

True 

DI8-4 

is 

True 

DI8-2 

is 

True 

DI8-1 

is 

True 

value=128 

value=64 

value=32 

value=16 

value=8 

value=4 

value=2 

value=l 


STATUS Register 9 BCD Digits DI9 and DI10 


Bit 7 

Bit 6 

Bit 5 

Bit 4 

Bit 3 

Bit 2 

Bit 1 

Bit 0 

DI9-8 

is 

True 

DI9-4 is 
True 

DI9-2 is 
True 

DI9-1 is 
True 

DI10-8 

is 

Tue 

DI10-4 

is 

Tue 

Dll 0-2 
is 

Tue 

DI10-1 

is 

Tue 

value=128 

value=64 

value=32 

value=16 

value=8 

value=4 

value=2 

value=l 


EPROM Programmer 

STATUS and CONTROL Registers 


Note This section does not apply to BASIC/UX. 


STATUS Register 0 ID Register. This register contains a value of 

27 (decimal) which is the ID of an EPROM 
Programmer card. 
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2 


Bit 7 

Bit 6 

Bit 5 

Bit 4 

Bit 3 

Bit 2 

Bit 1 

Bit 0 

0 

0 

0 

1 

1 

0 

1 

1 

value=128 

value=64 

value=32 

value=16 

value=8 

value=4 

value=2 

value=l 


CONTROL Register 0 


STATUS Register 1 


CONTROL Register 1 


STATUS Register 2 


CONTROL Register 2 


STATUS Register 3 


CONTROL Register 3 


Interface Reset. Writing any non-zero value into 
this register resets the card; writing a value of zero 
causes no action. 

Read Program Time. A value of 0 indicates that 
the program time is 52.5 milliseconds for each 
16-bit word (default); a non-zero value indicates 
that the program time is 13.1 milliseconds. 

Set Program Time. Writing a value of 0 into this 
register sets the program time to 52.5 milliseconds 
for each 16-bit word; any non-zero value sets 
program time to 13.1 milliseconds. 

Read Target Address. This register contains the 
offset address (relative to the card’s base address) 
at which the next word of data will be read (via 
STATUS Register 3) or written (via CONTROL 
Register 3). The default address is 0, which is the 
address of the first byte on the card. 

Set Target Address. Writing to this register sets the 
offset address at which the next word of data will 
be read (via STATUS Register 3) or written (via 
CONTROL Register 3). The target address must 
always be an even number. 

Read Word at Target Address. This register 
contains the 16-bit word at the current target 
address. 

Write Word at Target Address. Writing a data 
word to this register programs a 16-bit word at the 
current target address. The target address must be 
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STATUS Register 4 


CONTROL Register 4 
STATUS Register 5 


CONTROL Register 5 
STATUS Register 6 


CONTROL Register 6 


set (via CONTROL register 2) before every word is 
written. Automatic verification is also performed 
after the word is programmed. 

Current Memory Card Capacity (in bytes). This 
register contains the current capacity of a fully 
loaded card in bytes; it also indirectly indicates 
which type of EPROM devices are being used 
on the card. If 262 144 is returned, then 27128 
EPROMs are being used; if 131 072 is returned, 
then 2764 devices are being used. A 0 is returned if 
the programmer card is not currently connected to 
any EPROM memory card. 

Undefined. 

Number of Contiguous, Erased Bytes. Reading 
this register causes the system to begin counting 
the number of subsequent bytes, beginning at the 
current target address, that are erased (or are 
empty sockets). The counting is stopped when a 
programmed byte (i.e., one containing at least one 
logical 0) is found or when the end of the card is 
reached. If the byte at the current target address 
is not FF, then a count of 0 is returned. Error 84 
is reported if the programmer card is not currently 
connected to any EPROM card. 

Undefined. 

Base Address of EPROM Memory Card. This 
register contains the (absolute) base address of the 
EPROM memory card to which the programmer 
card is currently connected; this base address is also 
the absolute address of the first word on the card. 
Error 84 is reported if the programmer card is not 
currently connected to any EPROM memory card. 

Undefined. 
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Parity, Cache, Float, and Clock 
STATUS and CONTROL Registers 
[Pseudo Select Code 32) 


STATUS Register 0 


CONTROL Register 0 


STATUS Register 1 


CONTROL Register 1 


STATUS Register 2 


CONTROL Register 2 


STATUS Register 3 


CONTROL Register 3 


Parity Checking for Memory Is Currently 
Enabled/Disabled 

0 = currently disabled; 1 = currently enabled 

Enable/Disable Parity Checking for Memory (not 
supported on BASIC/UX or BASIC/DOS) 

0 = disable; 1 = enable 

External (16 Kbyte) Cache Is Currently 
Enabled/Disabled 

0 = currently disabled; 1 = currently enabled 

Enable/Disable External (16 Kbyte) Cache (not 
supported on BASIC/UX or BASIC/DOS) 

0 = disable; 1 = enable 

Floating-Point Math Hardware Is Currently 
Enabled/Disabled (HP 98635 Card, MC68881, or 
MC68882 Co-Processor) 

0 = currently disabled; 1 = currently enabled 

Enable/Disable Floating-Point Math (HP 98635 
Card, MC68881 or MC68882 Co-Processor) 

0 = disable; 1 = enable 

MC68020 (256 Byte) or MC68030 Cache Is 
Currently Enabled/Disabled 

0 = currently disabled; 1 = currently enabled 

Enable/Disable MC68020 (256 Byte) or MC68030 
Cache (not supported on BASIC/UX) 

0 = disable; non-0 = enable 
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Note 

With computers that have a MC68030 processor, enabling or 
disabling this internal cache also enables/disables the external 
cache (since they are not independent). To determine which 
processor you have, use SYSTEM$(“SYSTEM ID”). A result of 
S300:20 indicates you have a 68020, and S300:30 indicates a 
68030 processor. 

STATUS Register 4 

Battery-Backed Clock Type 



0 = No battery-backed clock present; 

1 = Series 200 (98270) battery-backed clock 

present; 

2 = Series 300 (HP-HIL) battery-backed clock 

present 

STATUS Register 5 

Background Process and Redirection 



Bit 0 set: stdin redirected 

Bit 1 set: stdout redirected 

Bit 2 set: stderr redirected 

Bit 3 set: in background mode 


SRM Interface STATUS Registers 


BASIC/UX supports SRM STATUS Registers 3 and 6. All other 
registers either cause an error or return a value, depending on the current 
ERRORMODE setting (specified on the rmb command line or in the 
configuration file). If ERRORMODE is off, then STATUS Register 0 returns 
52, and all other registers return 0. 

STATUS Register 0 Card Identification 

52 if the Remote Control switch (R) is set to 0 
(closed); 180 if switch is set to 1 (open). 

STATUS Register 1 Interface Interrupts 

l=interrupts enabled; 0=interrupts disabled. 

STATUS Register 2 Interface Busy 
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STATUS Register 3 

STATUS Register 4 
STATUS Register 5 

STATUS Register 6 

STATUS Register 7 

STATUS Register 8 

STATUS Register 11 

STATUS Register 12 


l=busy; O=not busy. 

Interface Firmware ID 

Always 3 (the firmware ID of the SRM interface). 
Not Implemented 
Data Availability 
0= receiver buffer empty; 

1= receiver data available but no control blocks 
buffered: 

2= receiver control blocks available but no data 
buffered; 

3= both control blocks and data available. 

Node Address of SRM Interface 

Node address of the SRM interface installed in this 
computer which is set to the specified select code. 
The range of node addresses is 0 through 63. 

CRC Errors 

Total number of cyclic redundancy check (CRC) 
errors detected by the interface since powerup or 
(Resell ( (RESET) ). 

Number of Buffer Overflows 

Total number of times the receive buffer has 
overflowed since powerup or ( Reset 1 ( (RESET 1 ). 

Available space 

Amount of available space (number of bytes) in the 
transmit-data buffer. 

Number of Retries 

Number of transmission retries performed since 
powerup Or ( Reset 1 ( (reset ) ). 
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2 EXT Signal Registers 



Note This section applies to HP BASIC/UX only 


STATUS Register 0 
STATUS Register 1 


STATUS Register 2 
STATUS Register 32 


Last un-caught EXT Signal 0 

Status of EXT Signal 1 

— 1 Not catchable 
0 Disabled 

1 Disabled 

Status of EXT Signal 2 

Status of EXT Signal 32 
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L Missing option or configuration error. 

■ If a statement requires an option which is not loaded, the option 
number or option name (see following table) is given along with 
error 1. 

■ Error 1 without an option number indicates other configuration 
errors. 

These option numbers are displayed when ERROR 1 is reported. 
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Option (Binary) Numbers 


No. 

Name 

No. 

Name 

1 

BASIC Main 

26 

FHPIB 

2 

GRAPH 

27 

SERIAL 

3 

GRAPHX 

28 

GPIO 

4 

10 

29 

BCD 

5 

BASIC Main 

30 

DCOMM 

6 

TRANS 

31-40 

Reserved 

7 

MAT 

41 

Unavailable 

8 

PDEV 

42 

CRTB 

9 

XREF 

43 

CRTA 

10 

KBD 

44 

CRTD 

11 

CLOCK 

45 

Reserved 

12 

LEX 

46 

COMPLEX 

13 

BASIC Main 

47 

CRTX 

14 

MS 

48 

EDIT 

15 

SRM 

50 

HFS 

16 

COMPILER 2 

51 

RMBUX 

17 


54 

LAN 

18 

KNB2.0 

56 

MCMATH 

19 

ERR 

61 

LANGUAGE 

20 

DISC 

62 

FONT 

21 

CS80 

63 

INPUT 

22 

BUBBLE 

64 

Reserved 

23 

EPROM 

65 

Reserved 

24 

HP 9885 

66 

SCSI 

25 

HPIB 

68 

PLLEL 


2 This binary is included to support the software for the HP98647 PC 
Instruments Interface. It is not supplied with the BASIC 6.0 System. 
2 The COMPILER for BASIC/WS/DOS is sold as a separate product. A 
compiler is included in BASIC/UX. 
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2 Memory overflow. If you get this error while loading a file, the 
program is too large for the computer’s memory. If the program 
loads, but you get this error when you press RUN, then the 
overflow was caused by the variable declarations. Either way, you 
need to modify the program or add more read/write memory. 

3 Line not found in current context. Could be a GOTO or GOSUB 3 
that references a non-existent (or deleted) line, or an EDIT 

command that refers to a non-existent line label. 

4 Improper RETURN. Executing a RETURN statement without 
previously executing an appropriate GOSUB or function call. Also, 
a RETURN statement in a user-defined function with no value 
specified. 

5 Improper context terminator. You forgot to put an END 
statement in the program. Also applies to SUBEND and FNEND. 

6 Improper FOR ... NEXT matching. Executing a NEXT 
statement without previously executing the matching FOR 
statement. Indicates improper nesting or overlapping of the loops. 

7 Undefined function or subprogram. Attempt to call a SUB or 
user-defined function that is not in memory. Look out for program 
lines that assumed an optional CALL. 

3 Improper parameter matching. A type mismatch between a pass 

parameter and a formal parameter of a subprogram. 

3 Improper number of parameters. Passing either too few or too 

many parameters to a subprogram. Applies only to non-optional 
parameters. 

10 String type required. Attempting to return a numeric from a 
user-defined string function. 

11 Numeric type required. Attempting to return a string from a 
user-defined numeric function. 

12 Attempt to redeclare variable. Including the same variable name 
twice in declarative statements such as DIM or INTEGER. 
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13 


14 


3 


15 

16 

17 

18 


19 


20 

22 

24 

25 

26 


Array dimensions not specified. Using the (*) symbol after a 
variable name when that variable has never been declared as an 
array. 

OPTION BASE not allowed here. The OPTION BASE statement 
must appear before any declarative statements such as DIM or 
INTEGER. Only one OPTION BASE statement is allowed in one 
context. 

Invalid bounds. Attempt to declare an array with more than 32 
767 elements or with upper bound less than lower bound. 

Improper or inconsistent dimensions. Using the wrong number of 
subscripts when referencing an array element. 

Subscript out of range. A subscript in an array reference is outside 
the current bounds of the array. 

String overflow or substring error. String overflow is an attempt 
to put too many characters into a string (exceeding dimensioned 
length). This can happen in an assignment, an ENTER an 
INPUT, or a READ. A substring error is an attempted violation 
of the rules for substrings. Watch out for null strings where you 
weren’t expecting them. 

Improper value or out of range. A value is too large or too small. 
Applies to items found in a variety of statements. Often occurs 
when the number builder overflows (or underflows) during an I/O 
operation. 

INTEGER overflow. An assignment or result exceeds the range 
allowed for INTEGER variables. Must be —32 768 thru 32 767. 

REAL overflow. An assignment or result exceeds the range allowed 
for REAL variables. 

Trig argument too large for accurate evaluation. Out-of-range 
argument for a function such as TAN or LDIR. 

Magnitude of ASN or ACS argument is greater than 1. Arguments 
to these functions must be in the range —1 thru +1. 

Zero to non-positive power. Exponentiation error. 
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27 Negative base to non-integer power. Exponentiation error. 

28 LOG or LGT of a non-positive number. 

29 Illegal floating point number. Does not occur as a result of any 
calculations, but is possible when a FORMAT OFF I/O operation 
fills a REAL variable with something other than a REAL number. 

30 SQR of a negative number. 

31 Division (or MOD) by zero. 

32 String does not represent a valid number. Attempt to use 
“non-numeric” characters as an argument for VAL, data for a 
READ, or in response to an INPUT statement requesting a 
number. 

33 Improper argument for NUM or RPT$. Null string not allowed. 

34 Referenced line not an IMAGE statement. A USING clause 
contains a line identifier, and the line referred to is not an IMAGE 
statement. 

35 Improper image. See IMAGE or the appropriate keyword in the 
BASIC Language Reference. 

36 Out of data in READ. A READ statement is expecting more data 
than is available in the referenced DATA statements. Check for 
deleted lines, proper OPTION BASE, proper use of RESTORE, or 
typing errors. 

38 TAB or TABXY not allowed here. The tab functions are not 

allowed in statements that contain a USING clause. TABXY is 
allowed only in a PRINT statement. 

40 Improper REN, COPYLINES, or MOVELINES command. Line 
numbers must be whole numbers from 1 to 32 766. This may also 
result from a COPYLINES or MOVELINES statement whose 
destination line numbers lie within the source range. 

41 First line number greater than second line number. Parameters 
out of order in a statement like SAVE, LIST, or DEL. 
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43 Matrix must be square. The MAT functions: IDN, INV, and DET 
require the array to have equal numbers of rows and columns. 

44 Result cannot be an operand. Attempt to use a matrix as both 
result and argument in a MAT TRN or matrix multiplication. 

46 Attempting a SAVE when there is no program in memory. 

47 COM declarations are inconsistent or incorrect. Includes such 
things as mismatched dimensions, unspecified dimensions, and 
blank COM occurring for the first time in a subprogram. 

49 Branch destination not found. A statement such as ON ERROR or 

ON KEY refers to a line that does not exist. Branch destinations 
must be in the same context as the ON ... statement. 

51 File not currently assigned. Attempting an ON/OFF END 
statement with an unassigned I/O path name. 

52 Improper mass storage volume specifier. The characters used for a 
msvs do not form a valid specifier. This could be a missing colon, 
too many parameters, illegal characters, etc. 

53 Improper file name. The file name is too long or has characters 
that are not allowed. LIF file names are limited to 10 characters; 
SRM file names to 16 characters; HFS file names to 14 characters. 
Foreign characters are allowed, but punctuation (in commands, 
etc.) is not. 

54 Duplicate file name. The specified file name already exists in 
directory. It is illegal to have two files with the same name on one 
LIF volume or in the same SRM or HFS directory. 

55 Directory overflow. Although there may be room on the media for 
the file, there is no room in the directory for another file name. 

LIF Disks initialized by BASIC have room for over 100 entries 

in the directory, but other systems may make a directory of a 
different size. 

56 File name is undefined. The specified file name does not exist 
in the directory. Check the contents of the disk with a CAT 
command. 
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58 Improper file type. Many mass storage operations are limited to 
certain file types. For example, LOAD is limited to PROG files 
and ASSIGN is limited to ASCII, BDAT, and HP-UX files. 

59 End of file or buffer found. For files: No data left when reading 
a file, or no space left when writing a file. For buffers: No data 
left for an ENTER, or no buffer space left for an OUTPUT. Also, 
WORD-mode TRANSFER terminated with odd number of bytes. 

60 End of record found in random mode. Attempt to ENTER or 
OUTPUT a field that is larger than a defined record. 

62 Protect code violation. Failure to specify the protect code of a 

protected file, or attempting to protect a file of the wrong type. 

64 Mass storage media overflow. The disk is full. (There is not 
enough free space for the specified file size, or not enough 
contiguous free space on a LIF disk.) 

65 Incorrect data type. The array used in a graphics operation, such 
as GLOAD, is the wrong type (INTEGER or REAL). 

66 INITIALIZE failed. Too many bad tracks found. The disk is 
defective, damaged, or dirty. 

67 Illegal mass storage parameter. A mass storage statement contains 
a parameter that is out of range, such as a negative record number 
or an out of range number of records. 

68 Syntax error occurred during GET. One or more lines in the file 
could not be stored as valid program lines. The offending lines are 
usually listed on the system printer. Also occurs if the first line in 
the file does not start with a valid line number. 

72 Disk controller not found or bad controller address. The msus 
contains an improper device selector, or no external disk is 
connected. 

73 Improper device type in mass storage volume specifier. The msvs 
has the correct general form, but the characters used for a device 
type are not recognized. 

76 Incorrect unit number in mass storage volume specifier. The msvs 

contains a unit number that does not exist on the specified device. 
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77 Operation not allowed on open file. The specified file is assigned to 
an I/O path name which has not been closed. 

78 Invalid mass storage volume label. Usually indicates that the 
media has not been initialized on a compatible system. Could also 
be a bad disk. 

79 File open on target device. Attempt to copy an entire volume with 
a file open on the destination disk. 

80 Disk changed or not in drive. Either there is no disk in the drive 
or the drive door was opened while a file was assigned. 

81 Mass storage hardware failure. Also occurs when the disk is 
pinched and not turning. Try reinserting the disk. 

82 Mass storage volume not present. Hardware problem or an 
attempt to access a left-hand drive on the Model 226. 

83 Write protected. Attempting to write to a write-protected disk. 
This includes many operations such as PURGE, INITIALIZE, 
CREATE, SAVE, OUTPUT, etc. 

84 Record not found. Usually indicates that the media has not been 
initialized. 

85 Media not initialized. (Usually not produced by the internal 
drive.) 

87 Record address error. Usually indicates a problem with the media. 

88 Read data error. The media is physically or magnetically 
damaged, and the data cannot be read. 

89 Checkread error. An error was detected when reading the data 
just written. The media is probably damaged. 

90 Mass storage system error. Usually a problem with the hardware 
or the media. 

93 Incorrect volume code in msvs. The msvs contains a volume 

number that does not exist on the specified device. 

100 Numeric IMAGE for string item. 

101 String IMAGE for numeric item. 
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102 Numeric field specifier is too large. Specifying more than 256 
characters in a numeric field. 

103 Item has no corresponding IMAGE. The image specifier has no 

fields that are used for item processing. Specifiers such as # X / 
are not used to process the data for the item list. Item-processing 
specifiers include things like K D B A. 3 

105 Numeric IMAGE field too small. Not enough characters are 
specified to represent the number. 

106 IMAGE exponent field too small. Not enough exponent characters 
are specified to represent the number. 

107 IMAGE sign specifier missing. Not enough characters are specified 
to represent the number. Number would fit except for the minus 
sign. 

117 Too many nested structures. The nesting level is too deep for such 
structures as FOR, SELECT, IF, LOOP, etc. 

118 Too many structures in context. Refers to such structures as 
FOR/NEXT, IF/THEN/ELSE, SELECT/CASE, WHILE, etc. 

120 Not allowed while program running. The program must be 
stopped before you can execute this command. 

121 Line not in main program. The run line specified in a LOAD or 
GET is not in the main context. 122 Program is not continuable. 

The program is in the stopped state, not the paused state. CONT 
is allowed only in the paused state. 

122 Program is not continuable. 

125 Program not running. 

126 Quote mark in unquoted string. Quote marks must be used in 
pairs. 

127 Statements which affect the knob mode are out of order. 

128 Line too long during GET. 

131 Unrecognized non-ASCII keycode. An output to the keyboard 

contained a CHR$(255) followed by an illegal byte. 
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132 

133 

134 
3 135 

136 

140 


141 

142 

143 


145 


146 

150 

152 

153 

154 

155 


Keycode buffer overflow. Trying to send too many characters to 
the keyboard buffer with an OUTPUT 2 statement. 

DELSUB of non-existent or busy subprogram. 

Improper SCRATCH statement. 

READIO/WRITEIO to nonexistent memory location. 

REAL underflow. The input or result is closer to zero than 10/ 308 
(approximately). 

Too many symbols in the program. Symbols are variable names, 
I/O path names, COM block names, subprogram names, and line 
identifiers. 

Variable cannot be allocated. It is already allocated. 

Variable not allocated. Attempt to DEALLOCATE a variable that 
was not allocated. 

Reference to missing OPTIONAL parameter. The subprogram 
is trying to use an optional parameter that didn’t have any 
value passed to it. Use NPAR to check the number of passed 
parameters. 

May not build COM at this time. Attempt to add or change 
COM when a program is running. For example, a program does a 
LOADSUB and the COM in the new subprogram does not match 
existing COM. 

Duplicate line label in context. There cannot be two lines with the 
same line label in one context. 

Illegal interface select code or device selector. Value out of range. 
Parity error. 

Insufficient data for ENTER. A statement terminator was received 
before the variable list was satisfied. 

String greater than 32 767 bytes in ENTER. 

Improper interface register number. Value out of range or 
negative. 
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156 Illegal expression type in list. For example, trying to ENTER into 
a constant. 

157 No ENTER terminator found. The variable list has been satisfied, 
but no statement terminator was received in the next 256 
characters. The # specifier allows the statement to terminate when 

the last item is satisfied. 3 

158 Improper image specifier or nesting images more than 8 deep. 

The characters used for an image specifier are improper or in an 
improper order. 

159 Numeric data not received. When entering characters for a 
numeric field, an item terminator was encountered before any 
“numeric” characters were received. 

160 Attempt to enter more than 32 767 digits into one number. 

163 Interface not present. The intended interface is not present, set to 
a different select code, or is malfunctioning. 

164 Illegal BYTE/WORD operation. Attempt to ASSIGN with the 
WORD attribute to a non-word device. 

165 Image specifier greater than dimensioned string length. 

167 Interface status error. Exact meaning depends upon the interface 
type. With HP-IB, this can happen when a non-controller 
operation by the computer is aborted by the bus. 

168 Device timeout occurred and the ON TIMEOUT branch could not 
be taken. 

170 I/O operation not allowed. The I/O statement has the proper 
form, but its operation is not defined for the specified device. For 
example, using an HP-IB statement on a non-HP-IB interface or 
directing a LIST to the keyboard. 

171 Illegal I/O addressing sequence. The secondary addressing in 
a device selector is improper or primary address too large for 
specified device. 
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172 

173 
3 174 

177 

178 

180 

181 

182 

183 

185 

186 

187 

188 

189 

190 

191 

192 

193 

194 

195 

3-12 


Peripheral error. PSTS line is false. If used, this means that the 
peripheral device is down. If PSTS is not being used, this error 
can be suppressed by using control register 2 of the GPIO. 

Active or system controller required. The HP-IB is not active 
controller and needs to be for the specified operation. 

Nested I/O prohibited. An I/O statement contains a user-defined 
function. Both the original statement and the function are trying 
to access the same file or device. 

Undefined I/O path name. Attempting to use an I/O path name 
that is not assigned to a device or file. 

Trailing punctuation in ENTER. The trailing comma or semicolon 
that is sometimes used at the end of OUTPUT statements is not 
allowed at the end of ENTER statements. 

HFS disk may be corrupt. 

No room in HFS buffers. 

Not supported by HFS. 

Permission denied. You have insufficient access rights for the 
specified operation. 

HFS volumes must be mounted. 

Cannot open the specified directory. 

Cannot link across devices. 

Renaming using or / not allowed. 

Too many open files. 

File size exceeds the maximum allowed. 

Too many links to a file. 

Networking error. 

Resource deadlock would occur. 

Operation would block. 

Too many levels of a symbolic link. 
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196 Target device busy. 

197 Incorrect device type in device file. 

198 Invalid msvs mapping.(e.g., not a directory) 

199 Incorrect access to mounted HFS volume. 

200 Cannot access disk (e.g., uninitialized media) 

251 Bad dictionary specification. 

252 Improper dictionary file. 

253 Bad dictionary combination. 

254 Dictionary record overflow. 

255 Bad parameter in CVT$. 

256 Improper GFONT file. 

257 Bad parameter in EXCHANGE. 

258 Invalid HP-15 code. 

259 Dictionary not specified. 

260 Dictionary already in use. 

290 Invalid ESCAPE character. 

291 Too many matches. 

292 Wildcards not allowed. 

293 Operation failed on some files. 

294 Wildcard matches >1 item. 

295 Improper destination type. 

296 Unable to replace file. 

301 Cannot do while connected. 

303 Not allowed when trace active. 

304 Too many characters without terminator. 

306 Interface card failure. The datacomm card has failed self-test. 
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308 Illegal character in data. 

310 Not connected. 

313 US ART receive buffer overflow. Overrun error detected. Interface 
card is unable to keep up with incoming data rate. Data has been 
lost. 

314 Receive buffer overflow. Program is not accepting data fast enough 
to keep up with incoming data rate. Data has been lost. 

315 Missing data transmit clock. A transmit timeout has occurred 
because a missing data clock prevented the card from transmitting. 
The card has disconnected from the line. 

316 CTS false too long. The interface card was unable to transmit for 
a predetermined period of time because Clear-To-Send was false on 
a half-duplex line. The card has disconnected from the line. 

317 Lost carrier disconnect. Data Set Ready (DSR) or Data Carrier 
Detect (if full duplex) went inactive for too long. 

318 No activity disconnect. The card has disconnected from the line 
because no data was transmitted or received for a predetermined 
length of time. 

319 Connection not established. Data Set Ready or Data Carrier 
Detect (if full duplex) did not become active within a 
predetermined length of time. 

324 Card trace buffer overflow. 

325 Illegal databits/parity combination. Attempting to program 8 
bits-per-character and a parity of “1” or “0”. 

326 Register address out of range. A control or status register access 
was attempted to a non-existent register. 

327 Register value out of range. Attempting to place an illegal value in 
a control register. 

328 US ART Transmit underrun. 

330 User-defined LEXICAL ORDER IS table size exceeds array size. 
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331 Repeated value in pointer. A MAT REORDER vector has 
repeated subscripts. This error is not always caught. 

332 Non-existent dimension given. Attempt to specify a non-existent 
dimension in a MAT REORDER operation. 

333 Improper subscript in pointer. A MAT REORDER vector specifies 
a non-existent subscript. 

334 Pointer size is not equal to the number of records. A MAT 
REORDER vector has a different number of elements than the 
specified dimension of the array. 

335 Pointer is not a vector. Only single-dimension arrays (vectors) can 
be used as the pointer in a MAT REORDER or a MAT SORT 
statement. 

337 Substring key is out-of-range. The specified substring range of the 
sort key exceeds the dimensioned length of the elements in the 
array. 

338 Key subscript out-of-range. Attempt to specify a subscript in a 
sort key outside the current bounds of the array. 

340 Mode table too long. User-defined LEXICAL ORDER IS mode 
table contains more than 63 entries. 

341 Improper mode indicator. User-defined LEXICAL ORDER IS 
table contains an illegal combination of mode type and mode 
pointer. 

342 Not a single-dimension integer array. User-defined LEXICAL 
ORDER IS mode table must be a single-dimension array of type 
INTEGER. 

343 Mode pointer is out of range. User-defined LEXICAL ORDER IS 
table has a mode pointer greater than the existing mode table size. 

344 1 for 2 list empty or too long. A user-defined LEXICAL ORDER 
IS table contains an entry indicating an improper number of 1 for 
2 secondaries. 
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345 CASE expression type mismatch. The SELECT statement and its 
CASE statements must refer to the same general type, numeric or 
string. 

346 INDENT parameter out-of-range. The parameters must be in the 
range: 0 thru eight characters less than the screen width. 

347 Structures improperly matched. There is not a corresponding 
number of structure beginnings and endings. Usually means that 
you forgot a statement such as END IF, NEXT, END SELECT, 
etc. 

349 CSUB has been modified. A contiguous block of compiled 

subroutines has been modified since it was loaded. A single 
module that shows as multiple CSUB statements has been altered 
because program lines were inserted or deleted. 

353 Data link failure. 

369-398 Errors in this range are reported if a run-time Pascal error occurs 
in a CSUB. To determine the Pascal error number, subtract 400 
from the BASIC error number. Information on the Pascal error 
can be found in the Pascal Workstation System manual. 

401 Bad system function argument. An invalid argument was given to 

a time, date, base conversion, or SYSTEMS function. 

403 Copy failed; program modification incomplete. An error occurred 

during a COPYLINES or MOVELINES resulting in an incomplete 
operation. (Some lines may not have been copied or moved.) 

427 Priority may not be lowered. 

435 EXEC not allowed on this Binary. 

450 Volume not found—SRM error. 

451 Volume labels do not match—SRM error. 

453 File in use—SRM or HFS error. 

454 Directory formats do not match—SRM error. 

455 Possibly corrupt file—SRM error. 

456 Unsupported directory operation—SRM error. 
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457 Passwords not supported—SRM error. 

458 Unsupported directory format—SRM error. 

459 Specified file is not a directory—SRM or HFS error. 

460 Directory not empty—SRM or HFS error. 

461 Duplicate passwords not allowed. 

462 Invalid password—SRM error. 

465 Invalid rename or link across volumes. 

466 Duplicate volume entries. 

471 TRANSFER not supported by the interface. 

481 File locked or open exclusively—SRM error. 

482 Cannot move a directory with a RENAME operation—SRM or 
HFS error. 

483 System down—SRM error. 

484 Password not found—SRM error. 

485 Invalid volume copy—SRM or HFS error. 

488 DMA hardware required. HP 9885 disk drive requires a DMA card 

or is malfunctioning. 

511 The result array in a MAT INV must be of type REAL. 

516 Search key: improper dimensions. 

517 Search start out of range. 

519 HIL SEND Cmd arg out of range. 

520 Cmd not supported on active dev. 

521 Device sent Register I/O Error. 

522 Device not present. 

523 Statement requires HIL interface. 

526 Source: improper dimensions. 


Error Messages 3-17 



527 Source subscript out of range. 

528 Source: upper bound < lower bound. 

531 Source/destination mismatch. 

536 Dest.: improper dimensions. 

537 Dest. subscript out of range. 

538 Dest. upper bound < lower bound. 

540 HIL bus error. 

541 Keyboard interrupts disabled. Operation requires bit 0 of KBD 
STATUS/CONTROL register 7 to be 0. 

543 Redim error: improper dimensions. 

544 Redim not allowed on source. 

600 Attribute cannot be modified. The WORD/BYTE mode cannot 
be changed after assigning the I/O path name. 

601 Improper CONVERT lifetime. When the CONVERT attribute 
is included in the assignment of an I/O path name, the name of 
a string variable containing the conversion is also specified. The 
conversion string must exist as long as the I/O path name is valid. 

602 Improper BUFFER lifetime. The variable designated as a buffer 
during an I/O path name assignment must exist as long as the I/O 
path name is valid. 

603 Variable was not declared as a BUFFER. Attempt to assign 
a variable as a buffer without first declaring the variable as a 
BUFFER. 

604 Bad source or destination for a TRANSFER statement. Transfers 
are not allowed to the CRT, keyboard, or tape backup on CS80 
drives. Buffer to buffer or device to device transfers are not 
allowed. 

605 BDAT or HP-UX file type required. Only a BDAT or HP-UX file 
can be used in a TRANSFER operation. 
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606 Improper TRANSFER parameters. Conflicting or invalid 
TRANSFER parameters were specified, such as RECORDS 
without and EOR clause, or DELIM with an outbound 
TRANSFER. 

607 Inconsistent attributes. Such as CONVERT or PARITY with 

FORMAT OFF. 3 

609 IVAL or DVAL result too large. Attempt to convert a binary, 

octal, decimal, or hexadecimal string into a value outside the range 
of the function. 

611 Premature TRANSFER termination. 

612 BUFFER pointers in use. Attempt to change one or more buffer 
pointers while a TRANSFER is in progress. 

613 Cannot store a ROM system. 

620 COMPLEX value not allowed. 

623 ATN is undefined at +i and -i. 

624 ACSH/ATNH arg out of range. 

625 Bad SEARCH condition on COMPLEX. 

700 Improper plotter specifier. The characters used as a plotter 

specifier are not recognized. May be misspelled or contain illegal 
characters. 

702 CRT graphics hardware missing. Hardware problem. 

704 Upper bound not greater than lower bound. Applies to P2<=P1 

or VIEWPORT upper bound and CLIP limits. 705 VIEWPORT 
or CLIP beyond hard clip limits. 

705 VIEWPORT or CLIP off surface. 

706 Too many polygon edges. In BASIC/UX, the ability to fill 

polygons is dependent on the number of edges (different for each 
display type). 

708 Device not initialized. 

713 Request not supported by dev. 
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715 

730 

733 

810 

811 

812 

813 

814 

815 

816 

817 

818 

825 

826 
827 

830 

831 

832 

833 

840 

841 

842 

843 

844 
850 


Graphics not available 

Internal error occurred in Starbase library call 
GESCAPE opcode not recognized. 

Feature not supported on system. The value of system depends on 
the version of BASIC being used. 

Memory allocation failed. 

Out of semaphores. 

Semaphores deallocation error. 

Cannot access rmb lockfile. 

Cannot access HP-UX time. 

Invalid opcode in program. 

Cannot spawn new process. 

Kernel error setting signals. 

Default EXT SIGNAL received. 

EXECUTE process status failure. 

String too long for EXECUTE. 

Cannot open the pipe. 

Write to a broken pipe. 

Cannot seek on the pipe. 

Wrong directory data transfer in pipe. 

HIL mask error. 

CSUB run-time error. 

CSUB relocation error. 

Invalid CSUB version number. 

Invalid CSUB binary format. 

Iomap of device failed. 
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851 

Iounmap of device failed. 

852 

Iomap device file size wrong. 

862 

Window parameter out of range. 

863 

Not in a window system. 

864 

Window specifier out of range. 

865 

Window already exists. 

866 

Window does not exist. 

867 

Cannot create window. 

868 

Internal error occurred in X Window System library call 

880 

Current CRT is not bitmapped. 

881 

Array is not INTEGER type. 

882 

CHRX not matched by array dim. 

883 

CHRY not matched by array dim. 

897 

Array is not 1-dimensional. 

898 

Typing aid is too long. 

899 

Key number out of range. 

900 

Undefined typing aid key. 

901 

Typing aid memory overflow. 

902 

Must delete entire context. Attempt to delete a SUB or DEF FN 
statement without deleting its entire context. Easiest way to delete 
is with DELSUB. 

903 

No room to renumber. While EDIT mode was renumbering during 
an insert, all available line numbers were used between insert 
location and end of program. 

904 

Null FIND or CHANGE string. 

905 

CHANGE would produce a line too long for the system. Maximum 
line length is two lines on the CRT. 
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906 


909 


3 


910 


911 

920 

921 

922 

923 

924 

925 

926 

927 

928 

929 

930 

931 

932 

935 


SUB or DEF FN not allowed here. Attempt to insert a SUB or 
DEF FN statement into the middle of a context. Subprograms 
must be appended at the end. 

May not replace SUB or DEF FN. Similar to deleting a SUB or 
DEF FN. Attempted to insert lines: between a CSUB statement 
and the following SUB, DEF FN, or CSUB statement; or after a 
final CSUB statement at the end of the program. 

Identifier not found in this context. The keyboard-specified 
variable does not already exist in the program. Variables cannot 
be created from the keyboard; they must be created by running a 
program. 

Improper I/O list. 

Numeric constant not allowed. 

Numeric identifier not allowed. 

Numeric array element not allowed. 

Numeric expression not allowed. 

Quoted string not allowed. 

String identifier not allowed. 

String array element not allowed. 

Substring not allowed. 

String expression not allowed. 

I/O path name not allowed. 

Numeric array not allowed. 

String array not allowed. 

Excess keys specified. A sort key was specified following a key 
which specified the entire record. 

Identifier is too long: 15 characters maximum. 
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936 Unrecognized character. Attempt to store a program line 
containing an improper name or illegal character. 

937 Invalid OPTION BASE. Only 0 and 1 are allowed. 

939 OPTIONAL appears twice. A parameter list may have only one 
OPTIONAL keyword. All parameters listed before it are required, 
all listed after it are optional. 940 Duplicate formal parameter 
name. 

940 Duplicate formal param name. 

942 Invalid I/O path name. The characters after the Q are not a valid 
name. Names must start with a letter. 

943 Invalid function name. The characters after the FN are not a valid 
name. Names must start with a letter. 

946 Dimensions are inconsistent with previous declaration. The 
references to an array contain a different number of subscripts at 
different places in the program. 

947 Invalid array bounds. Value out of range, or more than 32 767 
elements specified. 

948 Multiple assignment prohibited. You cannot assign the same value 
to multiple variables by stating X=Y=Z=0. A separate assignment 
must be made for each variable. 

949 Syntax error at cursor. The statement you typed contains 
elements that don’t belong together, are in the wrong order, or are 
misspelled. 

950 Must be a positive integer. 

951 Incomplete statement. This keyword must be followed by other 
items to make a valid statement. 

954 Improper default specification. 

955 No range given. 

956 Source/destination mismatch. 

961 CASE expression type mismatch. The CASE line contains items 

that are not the same general type, numeric or string. 
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962 Programmable only: cannot be executed from the keyboard. 

963 Command only: cannot be stored as a program line. 

977 Statement is too complex. Contains too many operators and 

functions. Break the expression down so that it is performed by 
two or more program lines. 

980 Too many symbols in this context. Symbols include variable 

names, I/O path names, COM block names, subprogram names, 
and line identifiers. 

982 Too many subscripts: maximum of six dimensions allowed. 

983 Wrong type or number of parameters. An improper parameter list 
for a machine-resident function. 

985 Invalid quoted string. 

987 Invalid line number: must be a whole number 1 thru 32 766. 
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Useful Tables 


Interface Select Codes 


Internal Select Codes 


Select Code 

Device or Interface 

1 

Display (alpha) 

2 

Keyboard 

3 

Display (graphics) 

4 

Internal floppy-disk drive 

5 

Optional powerfail protection 

6 or 132 

Display (bit-mapped graphics) 

7 

HP-IB 

9 

RS-232 

14 or 28 

SCSI 

21 

LAN 

23 

HP Parallel interface (Centronics 
compatible) 
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Factory Presets for External Interfaces 


Select 

Code 

Device or Interface 

8 

HP-IB 

9 

RS-232 

10 

(not used) 

11 

BCD 

12 

GPIO 

14 

“High-Speed” HP-IB 

14 

SCSI 

20 

Data Communications 

21 

Shared Resource Management 

21 

LAN 

27 

EPROM Programmer 

28 

RGB Color Video 

30 

Bubble Memory 

32 

Pseudo Select Code (Parity, 

Cache, Floating-point math 
hardware, and battery-backed 
clock) 

33 

EXT SIGNAL Registers 
(BASIC/UX) 


4-2 Useful Tables 



Display Enhancement Characters 

BASIC uses certain characters as display enhancement characters. These 
characters do not occupy any space on the screen, nor do they produce 
any immediately visible effect. Display enhancement characters change the 
appearance of characters that follow. 

Globalized BASIC defines both one- and two-byte display enhancement 
characters. Refer to the globalization chapters of HP BASIC 6.2 Porting and 
Globalization for more information about two-byte characters. 

PRINT CHR$(132) ; A$;CHR$(128) underline on/off 

PRINT CHR$ (255)ftCHR$ (132); A$; CHR$ (255)&CHR$ (128) underline on/off 


Monochrome Display Enhancements 


Character 

Resulting Enhancement 

One-byte 

Two-byte 


CHR$(128) 

CHR$(255)&CHR$(128) 

All enhancements off 

CHR$(129) 

CHR$(255)&CHR$(129) 

Inverse video on 

CHR$(130) 

CHR$(255)&CHR$(130) 

Blinking on* 

CHR$(131) 

CHR$(255)&CHR$(131) 

Inverse video and blinking on 

CHR$(132) 

CHR$(255)&CHR$(132) 

Underline on 

CHR$(133) 

CHR$(255)ftCHR$(133) 

Underline and inverse video on 

CHR$(134) 

CHR$(255)&CHR$(134) 

Underline and blinking on* 

CHR$(135) 

CHR$(255)&CHR$(135) 

Underline, inverse video, and blinking on* 


Blinking not available on bit-mapped alpha displays. 
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Color Display Enhancements 


Character 

Resulting Enhancement 

One-byte 

Two-byte 

Model 236C 

Bit-mapped 

CHR$(136) 

CHR$(25S)&CHR$(136) 

White 

Pen 1 

CHR$(137) 

CHR$(255)&CHR$(137) 

Red 

Pen 2 

CHR$(138) 

CHR$(255)&CHR$(138) 

Yellow 

Pen 3 

CHR$(139) 

CHR$(255)&CHR$(139) 

Green 

Pen 4 

CHR$(140) 

CHR$(255)&CHR$(140) 

Cyan 

Pen 5 

CHR$(141) 

CHR$(255)&CHR$(141) 

Blue 

Pen 6 

CHR$(142) 

CHR$(255)&CHR$(142) 

Magenta 

Pen 7 

CHR$(143) 

CHR$(255)&CHR$(143) 

Black 

Pen 8 


CRT CONTROL registers 5 and 15 through 17 also provide a method of 
changing the alpha color. 

PRINTing CHR$(;c), where 136<s<143, will provide the same colors as on the 
Model 236C as long as the color map contains default values and the alpha 
write-enable mask includes planes 0 through 2. A user-defined color map which 
changes the values of pens 0 to 7 will change the meaning of CHR$(z). 


4-4 


Useful Tables 





























U.S. ASCII Character Codes 


ASCII 

Char. 

EQUIVALENT FORMS 

HP-IB 

Dec 

Binary 

Oct 

Hex 

NUL 

0 

00000000 

000 

00 


SOH 

1 

00000001 

001 

01 

GTL 

STX 

2 

00000010 

002 

02 


ETX 

3 

00000011 

003 

03 


EOT 

4 

00000100 

004 

04 

SDC 

ENQ 

5 

00000101 

005 

05 

PPC 

ACK 

6 

00000110 

006 

06 


BEL 

7 

00000111 

007 

07 


BS 

8 

00001000 

010 

08 

GET 

HT 

9 

00001001 

011 

09 

TCT 

LF 

10 

00001010 

012 

OA 


VT 

11 

00001011 

013 

OB 


FF 

12 

00001100 

014 

OC 


CR 

13 

00001101 

015 

OD 


SO 

14 

oooomo 

016 

OE 


SI 

15 

00001111 

017 

OF 


DLE 

16 

00010000 

020 

10 


DC1 

17 

00010001 

021 

11 

LLO 

DC2 

18 

00010010 

022 

12 


DC3 

19 

00010011 

023 

13 


DC4 

20 

00010100 

024 

14 

DCL 

NAK 

21 

00010101 

025 

15 

PPU 

SYNC 

22 

00010110 

026 

16 


ETB 

23 

00010111 

027 

17 


CAN 

24 

00011000 

030 

18 

SPE 

EM 

25 

00011001 

031 

19 

SPD 

SUB 

26 

00011010 

032 

1A 


ESC 

27 

00011011 

033 

IB 


FS 

28 

00011100 

034 

1C 


GS 

29 

00011101 

035 

ID 


RS 

30 

00011110 

036 

IE 


US 

31 

00011111 

037 

IF 



ASCII 

Char. 

EQUIVALENT FORMS 

HP-IB 

Dec 

Binary 

Oct 

Hex 

space 

32 

00100000 

040 

20 

LAO 

'■ 

33 

00100001 

041 

21 

LAI 

” 

34 

00100010 

042 

22 

LA2 

# 

35 

00100011 

043 

23 

LA3 

$ 

36 

00100100 

044 

24 

LA4 

% 

37 

00100101 

045 

25 

LA5 

& 

38 

00100110 

046 

26 

LA6 


39 

00100111 

047 

27 

LA7 

< 

40 

00101000 

050 

28 

LA8 


41 

00101001 

051 

29 

LA9 

* 

42 

00101010 

052 

2A 

LA10 

+ 

43 

00101011 

053 

2B 

LA11 

. 

44 

00101100 

054 

2C 

LA 12 

- 

45 

00101101 

055 

2D 

LA13 


46 

00101110 

056 

2E 

LAM 

/ 

47 

00101111 

057 

2F 

LA 15 

0 

48 

00110000 

060 

30 

LAI 6 

1 

49 

00110001 

061 

31 

LAI 7 

2 

50 

00110010 

062 

32 

LAI 8 

3 

51 

00110011 

063 

33 

LA19 

4 

52 

00110100 

064 

34 

LA20 

5 

53 

00110101 

065 

35 

LA21 

6 

54 

00110110 

066 

36 

LA22 

7 

55 

00110111 

067 

37 

LA23 

8 

56 

00111000 

070 

38 

LA24 

9 

57 

00111001 

071 

39 

LA25 


58 

00111010 

072 

3A 

LA26 

; 

59 

00111011 

073 

3B 

LA27 

< 

60 

00111100 

074 

3C 

LA28 

= 

61 

00111101 

075 

3D 

LA29 

> 

62 

00111110 

076 

3E 

LA30 

? 

63 

00111111 

077 

3F 

UNL 
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ASCII 

Char. 

EQUIVALENT FORMS 

HP-IB 

Dec 

Binary 

Oct 

Hex 

@ 

64 

01000000 

100 

40 

TAO 

A 

65 

01000001 

101 

41 

TA1 

B 

66 

01000010 

102 

42 

TA2 

C 

67 

01000011 

103 

43 

TA3 

D 

68 

01000100 

104 

44 

TA4 

E 

69 

01000101 

105 

45 

TA5 

F 

70 

01000110 

106 

46 

TA6 

Q 

71 

01000111 

107 

47 

TA7 

H 

72 

01001000 

110 

48 

TA8 

1 

73 

01001001 

111 

49 

TA9 

J 

74 

01001010 

112 

4A 

TA10 

K 

75 

01001011 

113 

4B 

TA11 

L 

76 

01001100 

114 

4C 

TA12 

M 

77 

01001101 

115 

4D 

TA13 

N 

78 

01001110 

116 

4E 

TA14 

0 

79 

01001111 

117 

4F 

TA15 

p 

80 

01010000 

120 

50 

TA16 

Q 

81 

01010001 

121 

51 

TA17 

R 

82 

01010010 

122 

52 

TA18 

S 

83 

01010011 

123 

53 

TA19 

T 

84 

01010100 

124 

54 

TA20 

U 

85 

01010101 

125 

55 

TA21 

V 

86 

01010110 

126 

56 

TA22 

w 

87 

01010111 

127 

57 

TA23 

X 

88 

01011000 

130 

58 

TA24 

Y 

89 

01011001 

131 

59 

TA25 

z 

90 

01011010 

132 

5A 

TA26 

[ 

91 

01011011 

133 

5B 

TA27 

\ 

92 

01011100 

134 

5C 

TA28 

] 

93 

01011101 

135 

5D 

TA29 

“ 

94 

01011110 

136 

5E 

TA30 

- 

95 

01011111 

137 

5F 

UNT 


ASCII 

Char. 

EQUIVALENT FORMS 

HP-IB 

Dec 

Binary 

Oct 

Hex 


96 

01100000 

140 

60 

SCO 

a 

97 

01100001 

141 

61 

SCI 

b 

98 

01100010 

142 

62 

SC2 

c 

99 

01100011 

143 

63 

SC3 

d 

100 

01100100 

144 

64 

SC4 

• 

101 

01100101 

145 

65 

SC5 

f 

102 

01100110 

146 

66 

SC6 

9 

103 

01100111 

147 

67 

SC7 

h 

104 

01101000 

150 

68 

SC8 

i 

105 

01101001 

151 

69 

SC9 

i 

106 

01101010 

152 

6A 

SC10 

k 

107 

01101011 

153 

6B 

sen 

1 

108 

01101100 

154 

6C 

SC12 

m 

109 

01101101 

155 

6D 

SCI 3 

" 

110 

01101110 

156 

6E 

SCI 4 

0 

111 

01101111 

157 

6F 

SC15 

P 

112 

01110000 

160 

70 

SCI 6 

q 

113 

01110001 

161 

71 

SCI 7 

- 

114 

01110010 

162 

72 

SC18 

s 

115 

01110011 

163 

73 

SC 19 

t 

116 

01110100 

164 

74 

SC20 

u 

117 

01110101 

165 

75 

SC21 

V 

118 

01110110 

166 

76 

SC22 

" 

119 

01110111 

167 

77 

SC23 

X 

120 

01111000 

170 

78 

SC24 

y 

121 

01111001 

171 

79 

SC25 

2 

122 

01111010 

172 

7A 

SC26 

( 

123 

01111011 

173 

7B 

SC27 

1 

124 

01111100 

174 

7C 

SC28 

1 

125 

01111101 

175 

7D 

SC29 

- 

126 

01111110 

176 

7E 

SC30 

DEL 

127 

01111111 

177 

7F 

SC31 



4-6 Useful Tables 




U.S./European Display Characters 

These characters can be displayed on the alpha screens of Models 216, 220 (with a 98204A 
display), 226, and 236 Computers. 


ESS 

EQUIVALENT FORMS 

Dec 

Binary 

H 

0 

00000000 


1 

00000001 


2 

00000010 

E, 

3 

00000011 

Er 

4 

00000100 

Eg 

5 

00000101 

% 

6 

00000110 

. 0 . 

7 

00000111 

Ec 

8 

00001000 

" T 

9 

00001001 

if 

10 

00001010 

* 

11 

00001011 

% 

12 

00001100 


13 

00001101 

% 

14 

00001110 

-I 

15 

00001111 

D 

16 

00010000 


17 

00010001 

% 

10 

00010010 

£ ;: 

19 

00010011 


20 

00010100 

r !: 

21 

00010101 

J '- 

22 

00010110 

% 

23 

00010111 

N 

24 

00011000 

E. 

25 

00011001 

% 

26 

00011010 

E: 

27 

00011011 

F- 

28 

00011100 

& 

29 

00011101 

P J 

30 

00011110 


31 

00011111 



EQUIVALENT FORMS 

Dec 



96 

01100000 

a 

97 

01100001 

b 

98 

01100010 

c 

99 

01100011 

d 

100 

01100100 

e 

101 

01100101 

f 

102 

01100110 

g 

103 

01100111 

h 

104 

01101000 

i 

105 

01101001 

i 

106 

01101010 


107 

01101011 

] 

108 

01101100 

rn 

109 

01101101 

n 

110 

01101110 

o 

111 

01101111 

p 

112 

01110000 

q 

113 

01110001 

r 

114 

01110010 

S 

115 

01110011 

t. 

116 

01110100 

u 

117 

01110101 

V 

118 

01110110 

I...I 

119 

01110111 


120 

01111000 

y 

121 

01111001 

z 

122 

01111010 


123 

01111011 

! 

124 

01111100 


125 

01111101 

■ 

126 

01111110 

H 

127 

01111111 


HR 

EQUIVALENT FORMS 

Dec 

Binary 

1? 

64 

01000000 

H 

65 

01000001 

B 

66 

01000010 

c 

67 

01000011 

D 

68 

01000100 

H 

69 

01000101 

fl 

70 

01000110 

E 

71 

01000111 

H 

72 

01001000 

I 

73 

01001001 

J 

74 

01001010 

K 

75 

01001011 

L 

76 

01001100 

M 

77 

01001101 

N 

78 

01001110 

” 

79 

01001111 

p 

80 

01010000 

Q 

81 

01010001 

R 

82 

01010010 

s 

83 

01010011 

T 

84 

01010100 

B 

85 

01010101 

B 

86 

01010110 

w 

87 

01010111 


88 

01011000 

v 

89 

01011001 

2 

90 

01011010 

[ 

91 

01011011 


92 

01011100 

] 

93 

01011101 


94 

01011110 

- 

95 

01011111 


E33 

EQUIVALENT FORMS 

Dec 


■ 

32 

00100000 

1 

33 

00100001 

B 

34 

00100010 

# 

35 

00100011 

■t 

36 

00100100 


37 

00100101 


38 

00100110 


39 

00100111 

< 

40 

00101000 

> 

41 

00101001 

* 

42 

00101010 

+ 

43 

00101011 

' 

44 

00101100 

- 

45 

00101101 


46 

00101110 


47 

00101111 

0 

48 

00110000 

i 

49 

00110001 

2 

50 

00110010 

3 

51 

00110011 

4 

52 

00110100 

5 

53 

00110101 

s 

54 

00110110 

? 

55 

00110111 

8 

56 

00111000 

9 

57 

00111001 


58 

00111010 

5 

59 

00111011 


60 

00111100 

= 

61 

00111101 


62 

00111110 

•? 

63 

00111111 


Useful Tables 4-7 


























U.S./European Display Characters 

These characters can be displayed on the alpha screens of Models 216, 220 (with a 98204A 
display), 226, and 236 Computers. 


ASCII 

Char. 

EQUIVALENT FORMS 

Dec 

Binary 

* 

160 

10100000 

H 

161 

10100001 

R 

162 

10100010 

E 

163 

10100011 

E 

164 

10100100 

E 

165 

10100101 

I 

166 

10100110 

I 

167 

10100111 


168 

10101000 


169 

10101001 


170 

10101010 


171 

10101011 


172 

10101100 

!J 

173 

10101101 

IJ 

174 

10101110 

il 

175 

10101111 


176 

10110000 

V 

177 

10110001 

y 

178 

10110010 


179 

10110011 

c 

180 

10110100 

s 

181 

10110101 

R 

182 

10110110 

n 

183 

10110111 

i 

184 

10111000 

■i 

185 

10111001 

Q 

186 

10111010 

£ 

187 

10111011 

h> 

188 

10111100 

s 

189 

10111101 

Fp. 

190 

10111110 

V 

191 

10111111 


HHl 

EQUIVALENT FORMS 

Dec 

■noon 


128 

10000000 

►p 

129 

10000001 


130 

10000010 

h F- 

131 

10000011 

! f. 

132 

10000100 

►p 

133 

10000101 

>p 

134 

10000110 

>p 

135 

10000111 

tp 

136 

10001000 

>p 

137 

10001001 

¥ 

138 

10001010 

^p 

139 

10001011 

>P 

140 

10001100 

►p 

141 

10001101 

h P 

142 

10001110 

f P 

143 

10001111 

h F- 

144 

10010000 

>r 

145 

10010001 

h F- 

146 

10010010 

T 

147 

10010011 

f p 

148 

10010100 

Fp 

149 

10010101 

Fp 

150 

10010110 

* 

151 

10010111 

>p 

152 

10011000 

h- 

153 

10011001 

h- 

154 

10011010 

>p 

155 

10011011 

V 

156 

10011100 

h- 

157 

10011101 

F P . 

158 

10011110 


159 

10011111 



EQUIVALENT FORMS 

Dec 

Binary 

a 

192 

11000000 

e 

193 

11000001 

6 

194 

11000010 

u 

195 

11000011 

a 

196 

11000100 

e 

197 

11000101 

6 

198 

11000110 

u 

199 

11000111 

•5t 

200 

11001000 

e 

201 

11001001 

o 

202 

11001010 

U 

203 

11001011 

■El 

204 

11001100 

e 

205 

11001101 

O 

206 

11001110 

u 

207 

11001111 

FI 

208 

11010000 

’■ 

209 

11010001 

0 

210 

11010010 

ft 

211 

11010011 


212 

11010100 


213 

11010101 

e> 

214 

11010110 

* 

215 

11010111 

R 

216 

11011000 

i 

217 

11011001 

0 

218 

11011010 

IJ 

219 

11011011 

i 

220 

11011100 

1 

221 

11011101 

B 

222 

11011110 

0 

223 

11011111 



EQUIVALENT FORMS 

Dec 

Binary 

R 

224 

11100000 

R 

225 

11100001 

a 

226 

11100010 

D 

227 

11100011 

d 

228 

11100100 

I 

229 

11100101 

I 

230 

11100110 

0 

231 

11100111 

0 

232 

11101000 

0 

233 

11101001 

° 

234 

11101010 

s 

235 

11101011 

S 

236 

11101100 

IJ 

237 

11101101 

V 

238 

11101110 

y 

239 

11101111 

■' 

240 

11110000 

y 

241 

11110001 


242 

11110010 

V 

243 

11110011 

►p 

244 

11110100 

h F' 

245 

11110101 

•F- 

246 

11110110 

f p 

247 

11110111 

Fp 

248 

11111000 

h F- 

249 

11111001 

Fp. 

250 

11111010 


251 

11111011 

•F- 

252 

11111100 


253 

11111101 

Fp. 

254 

11111110 


255 

11111111 


Note 1: Characters 128 thru 135 produce highlights on machines with monochrome highlights when used in PRINT and DiSP statements. 
Note 2: Characters 136 thru 143 change the color of text printed or displayed on machines capable of displaying text in color. 

Note 3: Characters 144 thru 159 are ignored by PRINT and DISP statements. 


4-8 Useful Tables 

























U.S./European Display Characters 

These characters can be displayed on the screen of Series 300 computers (except with 
a 98546 Display Compatibility Interface or 98700 Display Controller; see the preceding 
table). 

ASCII 


Nam 

Chr. 

Num. 

Chr . 

Num. 

Chr. 

Num. 

Chr. 

0 

N 

U 

32 


64 

0 

96 


1 

5 

H 

33 

t 

65 

A 

97 

a 

2 

9 

X 

34 

ll 

66 

B 

98 

b 

3 

E 

X 

35 

# 

67 

C 

99 

c 

4 

\ 

36 

$ 

68 

D 

100 

d 

5 

Q 

37 

% 

69 

E 

101 

e 

6 

K 

38 

& 

70 

F 

102 

f 

7 

4 

39 

l 

71 

G 

103 

g 

8 

B 

S 

40 

( 

72 

H 

104 

h 

9 

H 

T 

41 

) 

73 

I 

105 

i 

10 

L 

F 

42 

* 

74 

J 

106 

j 

11 

V 

T 

43 

+ 

75 

K 

107 

k 

12 

f f 

44 

i 

76 

L 

108 

1 

13 

c 

R 

45 

- 

77 

M 

109 

ro 

14 

l 

46 

• 

78 

N 

110 

n 

15 

5 

l 

47 

/ 

79 

O 

111 

o 

16 

O 

L 

48 

0 

80 

P 

112 

P 

17 

°1 

49 

1 

81 

Q 

113 

q 

18 

% 

50 

2 

82 

R 

114 

r 

19 

•4 

51 

3 

83 

S 

115 

s 

20 

°4 

52 

4 

84 

T 

116 

t 

21 

N 

K 

53 

5 

85 

U 

117 

u 

22 

S 

Y 

54 

6 

86 

V 

118 

V 

23 

% 

55 

7 

87 

W 

119 

w 

24 

C N 

56 

8 

88 

X 

120 

X 

25 

E m 

57 

9 

89 

Y 

121 

y 

26 

1 

58 

: 

90 

Z 

122 

z 

27 

l 

59 

) 

91 

[ 

123 

{ 

28 

F 9 

60 

< 

92 

\ 

124 

1 

29 

% 

61 

m 

93 

] 

125 

} 

30 

1 

62 

> 

94 

A 

126 

~ 

31 

5 

63 


95 

_ 

127 

1 


Useful Tables 4-9 


U.S./European Display Characters 

These characters can be displayed on the alpha screen of Series 200 Model 217, 220 (with 
98204B display), and 237 computers, and on Series 300 computers using a 98546 Display 
Compatibility Interface or 98700 Display Controller. 

ASCII 


Nutti 

Chr. 

Hum, 

Chr, 

Num. 

Chr. 

Num. 

Chr. 

128 

c 

L 

160 


192 

d 

224 

A 

129 

I 

M 

161 

A 

193 

§ 

225 

A 

130 

B 

G 

162 

A 

194 

6 

226 

a 

131 

I 

B 

163 

fe 

195 

a 

227 

D 

132 

U 

J. 

164 

£ 

196 

d 

228 

a 

133 

I 

J«! 

165 

E 

197 

6 

229 

i 

134 

B 

£ 

166 

t 

198 

6 

230 

± 

135 

I 

H 

167 

X 

199 

u 

231 

6 

136 

w 

H 

168 


200 

k 

232 

<b 

137 

R 

D 

169 


201 

& 

233 

0 

138 

Y 

E 

170 


202 

6 

234 

6 

139 

G 

R 

171 

** 

203 

u 

235 

£ 

140 

C 

Y 

172 


204 

a 

236 

§ 

141 

B 

U 

173 

O 

205 

e 

237 

0 

142 

M 

G 

174 

0 

206 

6 

238 

Y 

143 

B 

K 

175 

€ 

207 

ii 

239 

y 

144 

9 

O 

176 

— 

208 

A 

240 

* 

145 

9 

1 

177 

B 

1 

209 

S 

241 


146 

9 

2 

178 

B 

210 

0 

242 


147 

9 

3 

179 

' 

211 

A 

243 

F 

3 

148 

9 

4 

180 

c 

212 

a 

244 

F 

4 

149 

9 

5 

181 

5 

213 

i 

245 

I 

0 

150 

9 

E 

182 

ft 

214 

0 

246 

- 

151 

9 

7 

183 

Pi 

215 

£ 

247 


152 

9 

8 

184 

I 

216 

A 

248 

* 

153 

9 

9 

185 

i 

217 

1 

249 


154 

9 

A 

186 

a 

218 

6 

250 

& 

155 

9 

B 

187 

£ 

219 

0 

251 

« 

156 

9 

C 

188 

V 

220 

£ 

252 

■ 

157 

9 

D 

189 

§ 

221 

l 

253 

» 

158 

9 

E 

190 

/ 

222 

0 

254 

+ 

159 

9 

F 

191 

c 

223 

6 

255 

B 


4-10 Useful Tables 


U.S./European Display Characters 

These characters can be displayed on the alpha screen of Series 200 Model 217, 220 (with 
98204B display), and 237 computers, and on Series 300 computers using a 98546 Display 
Compatibility Interface or 98700 Display Controller. 

ASCII 


Num 

Chr, 

Hum. 

Chr . 

Hum. 

Chr. 

Num. 

Chr 

0 

N 

U 

32 


64 

0 

96 

\ 

1 

s 

H 

33 

; 

65 

A 

97 

a 

2 

9 

X 

34 

M 

66 

B 

98 

b 

3 

E x 

35 

# 

67 

C 

99 

c 

4 

\ 

36 

$ 

68 

D 

100 

d 

5 

E 

Q 

37 

% 

69 

E 

101 

e 

6 

a 

k 

38 

& 

70 

F 

102 

f 

7 

4 

39 

l 

71 

G 

103 

g 

8 

B 

S 

40 

( 

72 

H 

104 

h 

9 

H 

T 

41 

) 

73 

I 

105 

i 

10 

l f 

42 

* 

74 

J 

106 

3 

11 

V T 

43 

+ 

75 

K 

107 

k 

12 

F P 

44 

) 

76 

L 

108 

1 

13 

C 

R 

45 


77 

M 

109 

ro 

14 

1 

46 

« 

78 

N 

110 

n 

15 

S 

I 

47 

/ 

79 

O 

111 

o 

16 

0 

L 

48 

0 

80 

P 

112 

P 

17 


49 

1 

81 

Q 

113 

q 

18 


50 

2 

82 

P 

114 

r 

19 


51 

3 

83 

S 

115 

s 

20 

°4 

52 

4 

84 

T 

116 

t 

21 

N 

k 

53 

5 

85 

U 

117 

u 

22 

B 

Y 

54 

6 

86 

V 

118 

V 

23 

% 

55 

7 

87 

W 

119 

w 

24 

C N 

56 

8 

88 

X 

120 

X 

25 


57 

9 

89 

Y 

121 

y 

26 

% 

58 

: 

90 

Z 

122 

z 

27 


59 


91 

[ 

123 

< 

28 

F S 

60 

< 

92 

\ 

124 

1 

29 

% 

61 

m 

93 

] 

125 

} 

30 

% 

62 

> 

94 

A 

126 

- 

31 

u 

9 

63 

? 

95 


127 

« 


Useful Tables 4-11 


U.S./European Display Characters 

These characters can be displayed on the screen of Series 300 computers (except with 
a 98546 Display Compatibility Interface or 98700 Display Controller; see the preceding 
table). 

ASCII 


Nuro 

Chr. 

Hum, 

Chr, 

Hum. 

Chr. 

Hum. 

Chr 

128 

c 

L 

160 


192 

a 

224 

A 

129 

I 

V 

161 

A 

193 

a 

225 

A 

130 

B 

G 

162 

A 

194 

6 

226 

a 

131 

I 

B 

163 

fe 

195 

Q 

227 

D 

132 

U 

JL 

164 

£ 

196 

a 

228 

d 

133 

i 

J*! 

165 

E 

197 

a 

229 

± 

134 

B 

£ 

166 

± 

198 

6 

230 

± 

135 

I 

X 

167 

± 

199 

0 

231 

d 

136 

w 

H 

168 

' 

200 

a 

232 

b 

137 

R 

D 

169 

' 

201 

a 

233 

0 

138 

Y 

E 

170 


202 

6 

234 

5 

139 

G 

R 

171 

•• 

203 

Cl 

235 

£ 

140 

C 

Y 

172 


204 

a 

236 

§ 

141 

B 

U 

173 

0 

205 

e 

237 

u 

142 

M 

G 

174 

0 

206 

6 

238 

Y 

143 

B 

K 

175 

£ 

207 

u 

239 

y 

144 

9 

O 

176 


208 

A 

240 


145 

9 

1 

177 

Y 

209 

i 

241 


146 

9 

2 

178 

y 

210 

0 

242 


147 

9 

3 

179 

• 

211 

A 

243 

n 

148 

9 

a 

180 

C 

212 

a 

244 

i 

149 

9 

5 

181 

9 

213 

1 

245 

i 

0 

150 

9 

G 

182 

fl 

214 

0 

246 

— 

151 

9 

7 

183 

ft 

215 

m 

247 


152 

9 

8 

184 

i 

216 

A 

248 

* 

153 

9 

9 

185 

c 

217 

1 

249 

A 

154 

9 

A 

186 

a 

218 

o 

250 

& 

155 

9 

B 

187 

£ 

219 

0 

251 

« 

156 

9 

C 

188 

V 

220 

£ 

252 

■ 

157 

9 

D 

189 

§ 

221 

i 

253 

» 

158 

9 

E 

190 

/ 

222 

0 

254 

+ 

159 

9 

F 

191 

c 

223 

d 

255 

H 


4-12 Useful Tables 


Katakana Display Characters 

These characters can be displayed on the screen of Model 216, 217, 220, 226, and 236 
computers, and on Series 300 computers using a 98546 Display Compatibility Interface. 


EQUIVALENT FORMS 


EQUIVALENT FORMS 


Dec 

Binary 

32 

00100000 

33 

00100001 

34 

00100010 

35 

00100011 

36 

00100100 

37 

00100101 

38 

00100110 

39 

00100111 

40 

00101000 

41 

00101001 

42 

00101010 

43 

00101011 

44 

00101100 

45 

00101101 

46 

00101110 

47 

00101111 

48 

00110000 

49 

00110001 

50 

00110010 

51 

00110011 

52 

00110100 

53 

00110101 

54 

00110110 

55 

00110111 

56 

00111000 

57 

00111001 

58 

00111010 

59 

00111011 

60 

00111100 

61 

00111101 

62 

00111110 

63 

00111111 



EQUIVALENT FORMS 

IK239 


64 

01000000 

65 

01000001 

66 

01000010 

67 

01000011 

68 

01000100 

69 

01000101 

70 

01000110 

71 

01000111 

72 

01001000 

73 

01001001 

74 

01001010 

75 

01001011 

76 

01001100 

77 

01001101 

78 

01001110 

79 

01001111 

80 

01010000 

81 

01010001 

82 

01010010 

83 

01010011 

84 

01010100 

85 

01010101 

86 

01010110 

87 

01010111 

88 

01011000 

89 

01011001 

90 

01011010 

91 

01011011 

92 

01011100 

93 

01011101 

94 

01011110 

95 

01011111 



EQUIVALENT FORMS 



96 

01100000 

97 

01100001 

98 

01100010 

99 

01100011 

100 

01100100 

101 

01100101 

102 

01100110 

103 

01100111 

104 

01101000 

105 

01101001 

106 

01101010 

107 

01101011 

108 

01101100 

109 

01101101 

110 

01101110 

111 

01101111 

112 

01110000 

113 

01110001 

114 

01110010 

115 

01110011 

116 

01110100 

117 

01110101 

118 

01110110 

119 

01110111 

120 

01111000 

121 

01111001 

122 

01111010 

123 

01111011 

124 

01111100 

125 

01111101 

126 

01111110 

127 

01111111 
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Katakana Display Characters 

These characters can be displayed on the screen of Model 216, 217, 220, 226, and 236 
computers, and on Series 300 computers using a 98546 Display Compatibility Interface. 


m 

EQUIVALENT FORMS 

Dec 

Binary 

h- 

160 

10100000 

- 

161 

10100001 

r 

162 

10100010 

-> 

163 

10100011 


164 

10100100 


165 

10100101 

* 

166 

10100110 


167 

10100111 

< 

168 

10101000 

*^1 

169 

10101001 

I 

170 

10101010 

* 

171 

10101011 

t? 

172 

10101100 

n. 

173 

10101101 

3 

174 

10101110 

■» 

175 

10101111 

- 

176 

10110000 

7 

177 

10110001 

< 

178 

10110010 


179 

10110011 

I 

180 

10110100 

* 

181 

10110101 

£l 

182 

10110110 


183 

10110111 


184 

10111000 

T 

185 

10111001 

□ 

186 

10111010 

+r 

187 

10111011 


188 

10111100 

7 

189 

10111101 

t 

190 

10111110 

y 

191 

10111111 


ASCII 

Char. 

EQUIVALENT FORMS 

Dec 

■m 

y f- 

128 

10000000 

Fp 

129 

10000001 

H- 

130 

10000010 

if. 

131 

10000011 

if. 

132 

10000100 


133 

10000101 

h F- 

134 

10000110 

|, F- 

135 

10000111 

Fp 

136 

10001000 

Fp 

137 

10001001 

Fp 

138 

10001010 

Fp 

139 

10001011 

h- 

140 

10001100 

Fp 

141 

10001101 

Fp 

142 

10001110 

if. 

143 

10001111 

I F 

144 

10010000 

Fp 

145 

10010001 

Fp 

146 

10010010 

Fp 

147 

10010011 

Fp 

148 

10010100 

Fp 

149 

10010101 

Fp 

150 

10010110 

Fp 

151 

10010111 

Fp 

152 

10011000 

Fp 

153 

10011001 

Fp 

154 

10011010 

Fp 

155 

10011011 

Fp 

156 

10011100 

Fp 

157 

10011101 

Fp 

158 

10011110 

Fp 

159 

10011111 


IBM! 

EQUIVALENT FORMS 

Dec 

Binary 

■y 

192 

11000000 

4- 

193 

11000001 


194 

11000010 

T 

195 

11000011 

F- 

196 

11000100 

+ 

197 

11000101 


198 

11000110 

H 

199 

11000111 


200 

11001000 

..1 

201 

11001001 


202 

11001010 


203 

11001011 

7 

204 

11001100 


205 

11001101 

rh 

206 

11001110 

7 

207 

11001111 


208 

11010000 


209 

11010001 

B 

210 

11010010 

1 

211 

11010011 

V 

212 

11010100 


213 

11010101 


214 

11010110 


215 

11010111 


216 

11011000 

It. 

217 

11011001 

L- 

218 

11011010 

□ 

219 

11011011 

9 

220 

11011100 


221 

11011101 


222 

11011110 

" 

223 

11011111 



EQUIVALENT FORMS 

Dec 

■EEHSH 

Fp 

224 

11100000 


225 

11100001 


226 

11100010 


227 

11100011 


226 

11100100 


229 

11100101 


230 

11100110 


231 

11100111 

Fp 

232 

11101000 


233 

11101001 

Fp 

234 

11101010 


235 

11101011 

h- 

236 

11101100 

Fp 

237 

11101101 

Fp 

238 

11101110 

Fp 

239 

11101111 


240 

11110000 

Fp 

241 

11110001 

h- 

242 

11110010 

Fp 

243 

11110011 

Fp 

244 

11110100 


245 

11110101 


246 

11110110 

Fp 

247 

11110111 

Fp 

248 

11111000 

Fp 

249 

11111001 

Fp 

250 

11111010 

Fp 

251 

11111011 

T 

252 

11111100 

Fp 

253 

11111101 


254 

11111110 

a 

255 

11111111 


Note 1: Characters 128 thru 135 produce highlights on machines with monochrome highlights when used in PRINT and DISP statements. 
Note 2: Characters 136 thru 143 change the color of text printed or displayed on machines capable of displaying text in color. 

Note 3: Characters 144 thru 159 are ignored by PRINT and DISP statements. 
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Katakana Display Characters 

These characters can be displayed on the Model 237 and on all Series 300 bit-mapped 
alpha displays. 


n 

EQUIVALENT FORMS 

Dec 

E 3 H 3 EH 


96 

01100000 

a 

97 

01100001 

b 

96 

01100010 

c 

99 

01100011 

d 

100 

01100100 

e 

101 

01100101 

f 

102 

01100110 

g 

103 

01100111 

h 

104 

01101000 

i 

105 

01101001 


106 

01101010 

k 

107 

01101011 

1 

108 

01101100 

m 

109 

01101101 

n 

110 

01101110 

0 

111 

01101111 

p 

112 

01110000 

q 

113 

01110001 


114 

01110010 

s 

115 

oi noon 

t 

116 

omoioo 

u 

117 

01110101 


118 

01110110 


119 

01110111 


120 

01111000 


121 

01111001 


122 

01111010 


123 

01111011 


124 

01111100 


125 

01111101 


126 

01111110 


127 

01111111 


PR q 

EQUIVALENT FORMS 

Dec 


@ 

64 

01000000 

H 

65 

01000001 

E 

66 

01000010 

c 

67 

01000011 

D 

68 

01000100 

E 

69 

01000101 

F 

70 

01000110 

G 

71 

01000111 

H 

72 

01001000 

I 

73 

01001001 

■J 

74 

01001010 

K 

75 

01001011 

L. 

76 

01001100 

M 

77 

01001101 

N 

78 

01001110 

0 

79 

01001111 

p 

80 

01010000 

Q 

81 

01010001 

R 

82 

01010010 

s 

83 

01010011 


84 

01010100 

IJ 

85 

01010101 


86 

01010110 

W 

87 

01010111 


88 

01011000 


89 

01011001 


90 

01011010 

L 

91 

01011011 


92 

01011100 


93 

01011101 


94 

01011110 

- 

95 

01011111 


ASCII 

Cher. 

EQUIVALENT FORMS 

Dec 

BEQSSHi 

<1 

0 

00000000 



00000001 


2 

00000010 

E, 

3 

00000011 

Er 

4 

00000100 

* 

5 

00000101 

* 

6 

00000110 


7 

00000111 


8 

00001000 

" T 

9 

00001001 

if 

10 

00001010 

* 

11 

00001011 

Ff 

12 

00001100 

’p: 

13 

00001101 

* 

14 

00001110 

-I 

15 

00001111 

i> 

16 

00010000 

c i 

17 

00010001 

r.< : . 

18 

00010010 


19 

00010011 

D « 

20 

00010100 


21 

00010101 

* 

22 

00010110 

% 

23 

00010111 

* 

24 

00011000 


25 

00011001 

% 

26 

00011010 

k: 

27 

00011011 

Fj 

28 

00011100 

*■ 

29 

00011101 

% 

30 

00011110 

% 

31 

00011111 


eh 

EQUIVALENT FORMS 

Dec 

IE239H 


32 

00100000 

1 

33 

00100001 


34 

00100010 

# 

35 

00100011 

% 

36 

00100100 


37 

00100101 


38 

00100110 


39 

00100111 


40 

00101000 


41 

00101001 

* 

42 

00101010 

+ 

43 

00101011 

> 

44 

00101100 

- 

45 

00101101 


46 

00101110 


47 

00101111 

0 

48 

00110000 

i 

49 

00110001 

a 

50 

00110010 

3 

51 

00110011 


52 

00110100 


53 

00110101 

6 

54 

00110110 

7 

55 

00110111 

8 

56 

00111000 

9 

57 

00111001 


58 

00111010 


59 

00111011 


60 

00111100 

= 

61 

00111101 


62 

00111110 


63 

00111111 
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Katakana Display Characters 

These characters can be displayed on the Model 237 and on all Series 300 bit-mapped 
alpha displays. 


ASCII 

EQUIVALENT FORMS 

Char. 

Dec 

Binary 

c 

L 

128 

10000000 

V 

129 

10000001 

B 

G 

130 

10000010 

I 

B 

131 

10000011 

U 

L 

132 

10000100 

Si 

133 

10000101 

B 

£ 

134 

10000110 

I 

Si 

135 

10000111 

“h 

136 

10001000 

*0 

137 

10001001 

Y e 

138 

10001010 

G 

R 

139 

10001011 

C 

140 

10001100 

B 

U 

141 

10001101 

M 

G 

142 

10001110 

“k 

143 

10001111 

9 

0 

144 

10010000 

9 

1 

145 

10010001 

9 

2 

146 

10010010 

9 

3 

147 

10010011 

9 

148 

10010100 

9 

5 

149 

10010101 

9 

6 

150 

10010110 

9 

7 

151 

10010111 

9 

e 

152 

10011000 

9 

9 

153 

10011001 

9 

154 

10011010 

9 

B 

155 

10011011 

9 

C 

156 

10011100 




0 


10011101 

9 

E 

158 

10011110 

F 

159 

10011111 


ASCII 

EQUIVALENT FORMS 

Char. 

Dec 

Binary 

¥ 

160 

10100000 

» 

161 

10100001 

r 

162 

10100010 

■< 

163 

10100011 


164 

10100100 


165 

10100101 

=? 

166 

10100110 

7 

167 

10100111 

■< 

168 

10101000 

7 

169 

10101001 

I 

170 

10101010 

X 

171 

10101011 

p 

172 

10101100 

J1 

173 

10101101 

3 

174 

10101110 

„ 

175 

10101111 

- 

176 

10110000 

7 

177 

10110001 

•l’ 

178 

10110010 


179 

10110011 

I 

180 

10110100 

t 

181 

10110101 

T) 

182 

10110110 

f 

183 

10110111 


184 

10111000 

•1 

185 

lomooy 

□ 

186 

10111010 

It 

187 

10111011 


188 

10111100 

7 

189 

10111101 


190 

10111110 


191 

10111111 


ASCII 

EQUIVALENT FORMS 

. Char. 

Dec 

Binary 


192 

11000000 

=£• 

193 

11000001 


194 

11000010 

f 

195 

11000011 


196 

11000100 

t 

197 

11000101 

- 

198 

11000110 

■7 

199 

11000111 


200 

11001000 

.1 

201 

11001001 


202 

11001010 

t 

203 

11001011 

7 

204 

11001100 


205 

11001101 

7 

206 

11001110 

? 

207 

11001111 


208 

11010000 


209 

11010001 


210 

11010010 


211 

11010011 

-b 

212 

11010100 

2 

213 

11010101 

3 

214 

11010110 

7 

215 

11010111 

H 

216 

11011000 

11. 

217 

11011001 

1- 

218 

11011010 

n 

219 

11011011 

9 

220 

11011100 


221 

11011101 


222 

11011110 

» 

223 

11011111 


ASCII 

EQUIVALENT FORMS 

Char. 

Dec 

Binary 

E o 

224 

11100000 

E t 

225 

11100001 

E 2 

226 

11100010 

E 3 

227 

11100011 

E a 

228 

11100100 

E 5 

229 

11100101 

E 6 

230 

11100110 

E 7 

231 

11100111 

E 8 

232 

11101000 

E 8 

233 

11101001 

e a 

234 

11101010 

e b 

235 

11101011 

E c 

236 

11101100 

e d 

237 

11101101 

e e 

238 

11101110 

e f 

239 

11101111 

E o 

240 

11110000 

E ! 

241 

11110001 

F 2 

242 

11110010 

F 3 

243 

11110011 

F a 

244 

11110100 

*o 

245 

11110101 

e g 

246 

11110110 

E 7 

247 

11110111 

E 8 

248 

11111000 

E 8 

249 

11111001 

E fl 

250 

11111010 

f b 

251 

11111011 

■ 

252 

11111100 

e d 

253 

11111101 

f e 

254 

11111110 

a 

255 

11111111 


Note I: Characters 128 thru 135 produce highlights on machines with monochrome highlights when used in PRINT and DISP statements. 
Note 2: Characters 136 thru 143 change the color of text printed or displayed on machines capable of displaying text in color. 

Note 3: Characters 144 thru 159 are ignored by PRINT and DISP statements. 
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Lexical Tables 

The following tables show the live predefined lexical orders available with the 
LEXICAL ORDER IS statement. 

Notation 

All of the lexical tables use the following notation: 

sequence number: 113 
character displayed: a 

ASCII value: (97) 

Characters not available on the keyboard can be entered by pressing the 
[any char) key and typing the value enclosed in parenthesis (with leading zeros, 
if needed). The character will be collated according to the sequence number 
shown above the character. 
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LEXICAL ORDER IS ASCII 


Seq. 

Chr 

. Nam. 

Seq. 

Chr 

Nam, 

Seq. 

Chr , Num . 

Seq, 

Chr . Num . 

Seq. 

Chr . Num . 

0 

N 

U 

(0) 

52 

4 

(52) 

104 

h 

(104) 

156 

9 

C 

(156) 

208 

A 

(208) 

1 

5 

H 

(1) 

53 

5 

(53) 

105 

i 

(105) 

157 

9 

D 

(157) 

209 

1 

(209) 

2 

5 

X 

(2) 

54 

6 

(54) 

106 

j 

(106) 

158 

9 

E 

(158) 

210 

0 

(210) 

3 

c 

X 

(3) 

55 

7 

(55) 

107 

k 

(107) 

159 

9 

F 

(159) 

211 

A 

(211) 

4 

E 

T 

(4) 

56 

8 

(56) 

108 

1 

(108) 

160 


(160) 

212 

a 

(212) 

5 

E 

0 

(5) 

57 

9 

(57) 

109 

m 

(109) 

161 

A 

(161) 

213 

i 

(213) 

6 

A 

V. 

(6) 

58 

: 

(58) 

110 

n 

(110) 

162 

A 

(162) 

214 

a 

(214) 

7 

4 

(7) 

59 

> 

(59) 

111 

0 

(111) 

163 

t 

(163) 

215 

X 

(215) 

8 

B 

5 

(8) 

60 

< 

(60) 

112 

P 

(112) 

164 

fi 

(164) 

216 

A 

(216) 

9 

H 

T 

(9) 

61 

- 

(61) 

113 

q 

(113) 

165 

E 

(165) 

217 

1 

(217) 

10 

L 

F 

(10) 

62 

> 

(62) 

114 

r 

(114) 

166 

1 

(166) 

218 

b 

(218) 

11 

V 

T 

(ID 

63 

? 

(63) 

115 

s 

(115) 

167 

X 

(167) 

219 

0 

(219) 

12 

r r 

(12) 

64 

8 

(64) 

116 

t 

(116) 

168 

* 

(168) 

220 

& 

(220) 

13 

c 

R 

(13) 

65 

A 

(65) 

117 

u 

(117) 

169 

' 

(169) 

221 

l 

(221) 

14 

% 

(14) 

66 

B 

(66) 

118 

V 

(118) 

170 


(170) 

222 

3 

(222) 

15 

5 

r 

(15) 

67 

C 

(67) 

119 

w 

(119) 

171 

•• 

(171) 

223 

e> 

(223) 

16 

0 

L 

(16) 

68 

D 

(68) 

120 

X 

(120) 

172 


(172) 

224 

A 

(224) 

17 


(17) 

69 

E 

(69) 

121 

y 

(121) 

173 

0 

(173) 

225 

A 

(225) 

18 


(18) 

70 

F 

(70) 

122 

z 

(122) 

174 

0 

(174) 

226 

a 

(226) 

19 

% 

(19) 

71 

G 

(71) 

123 

{ 

(123) 

175 

€ 

(175) 

227 

D 

(227) 

20 

°4 

(20) 

72 

H 

(72) 

124 

1 

(124) 

176 

— 

(176) 

228 

d 

(228) 

21 

N 

k 

(21) 

73 

I 

(73) 

125 

> 

(125) 

177 

B 

1 

(177) 

229 

± 

(229) 

22 

s 

Y 

(22) 

74 

J 

(74) 

126 

- 

(126) 

178 

B 

2 

(178) 

230 

± 

(230) 

23 

E 

B 

(23) 

75 

K 

(75) 

127 

I 

(127) 

179 


(179) 

231 

6 

(231) 

24 

C 

N 

(24) 

76 

L 

(76) 

128 

c 

L 

(128) 

180 

Q 

(180) 

232 

6 

(232) 

25 

B M 

(25) 

77 

M 

(77) 

129 

I 

V 

(129) 

181 

9 

(181) 

233 

0 

(233) 

26 

I 

(26) 

78 

N 

(78) 

130 

B 

G 

(130) 

182 

fl 

(182) 

234 

5 

(234) 

27 

E 

C 

(27) 

79 

0 

(79) 

131 

I 

B 

(131) 

183 

n 

(183) 

235 

S 

(235) 

28 

F = 

(28) 

80 

P 

(80) 

132 

U 

L 

(132) 

184 

i 

(184) 

236 

§ 

(236) 

29 

6 

S 

(29) 

81 

Q 

(81) 

133 

I 

(133) 

185 

c 

(185) 

237 

0 

(237) 

30 

R 

S 

(30) 

82 

R 

(82) 

134 

B 

£ 

(134) 

186 

a 

(186) 

238 

Y 

(238) 

31 

u 

s 

(31) 

83 

S 

(83) 

135 

I 

Jl 

(135) 

187 

£ 

(187) 

239 

y 

(239) 

32 


(32) 

84 

T 

(84) 

136 

W 

H 

(136) 

188 

¥ 

(188) 

240 

* 

(240) 

33 

t 

(33) 

85 

U 

(85) 

137 

R 

D 

(137) 

189 

§ 

(189) 

241 


(241) 

34 

" 

(34) 

86 

V 

(86) 

138 

Y 

E 

(138) 

190 

/ 

(190) 

242 

F 

2 

(242) 

35 

# 

(35) 

87 

Vi 

(87) 

139 

G 

R 

(139) 

191 

c 

(191) 

243 

F 

3 

(243) 

36 

$ 

(36) 

88 

X 

(88) 

140 

C 

Y 

(140) 

192 

a 

(192) 

244 

F 

4 

(244) 

37 

% 

(37) 

89 

Y 

(89) 

141 

B 

U 

(141) 

193 

§ 

(193) 

245 

I 

□ 

(245) 

38 

& 

(38) 

90 

Z 

(90) 

142 

M 

G 

(142) 

194 

6 

(194) 

246 

- 

(246) 

39 

' 

(39) 

91 

C 

(91) 

143 

B 

K 

(143) 

195 

a 

(195) 

247 

i 

(247) 

40 

( 

(40) 

92 

\ 

(92) 

144 

9 

0 

(144) 

196 

A 

(196) 

248 

i 

(248) 

41 

) 

(41) 

93 

] 

(93) 

145 

9 

1 

(145) 

197 

4 

(197) 

249 

A 

(249) 

42 

* 

(42) 

94 


(94) 

146 

9 

2 

(146) 

198 

6 

(198) 

250 

£ 

(250) 

43 

+ 

(43) 

95 


(95) 

147 

9 

3 

(147) 

199 

0 

(199) 

251 

« 

(251) 

44 

> 

(44) 

96 

' 

(96) 

148 

9 

a 

(148) 

200 

A 

(200) 

252 

■ 

(252) 

45 


(45) 

97 

a 

(97) 

149 

9 

5 

(149) 

201 

4 

(201) 

253 

» 

(253) 

46 


(46) 

98 

b 

(98) 

150 

9 

6 

(150) 

202 

6 

(202) 

254 

♦ 

(254) 

47 

/ 

(47) 

99 

c 

(99) 

151 

9 

7 

(151) 

203 

0 

(203) 

255 

Q 

(255) 

48 

0 

(48) 

100 

d 

(100) 

152 

9 

B 

(152) 

204 

a 

(204) 




49 

1 

(49) 

101 

e 

(101) 

153 

9 

9 

(153) 

205 

e 

(205) 




50 

2 

(50) 

102 

f 

(102) 

154 

9 

A 

(154) 

206 

6 

(206) 




51 

3 

(51) 

103 

g 

(103) 

155 

9 

B 

(155) 

207 

u 

(207) 





4-18 Useful Tables 


LEXICAL ORDER IS FRENCH 


Seq. 

Chr 

Hum. 

Seq. 

Chr 

Hum. 

Seq, 

Chr 

. Num. 

Seq, 

Chr. Num. 

Seq. 

Chr. Num. 

0 

_ 

(45) 

51 

4 

(52) 

81 

P 

(80) 

113 

1 

(108) 

153 

i 

(248) 

0 

N 

U 

(0) 

52 

5 

(53) 

82 

Q 

(81) 

114 

m 

(109) 

154 

A 

(249) 

1 

fi 

H 

(1) 

53 

6 

(54) 

83 

R 

(82) 

115 

n 

(110) 

155 

& 

(250) 

2 

S 

X 

(2) 

54 

7 

(55) 

84 

S 

(83) 

116 

fi 

(183) 

156 

« 

(251) 

3 

E 

X 

(3) 

55 

8 

(56) 

85 

§ 

(235) 

117 

o 

(111) 

157 

■ 

(252) 

4 

s 

(4) 

56 

9 

(57) 

86 

T 

(84) 

117 

6 

(194) 

158 

» 

(253) 

5 

E 

0 

(5) 

57 

: 

(58) 

87 

U 

(85) 

117 

6 

(198) 

159 

+ 

(254) 

6 

fi 

K 

(6) 

58 

J 

(59) 

87 

0 

(173) 

117 

6 

(202) 

160 

1 

(127) 

7 

0 

(7) 

59 

< 

(60) 

87 

0 

(174) 

117 

6 

(206) 

161 


(160) 

8 

0 

5 

(8) 

60 

- 

(61) 

87 

u 

(219) 

117 

a 

(214) 

162 

B 

1 

(177) 

9 

H 

T 

(9) 

61 

> 

(62) 

87 

0 

(237) 

117 

S 

(234) 

163 

B 

2 

(178) 

10 

L 

F 

(10) 

62 

? 

(63) 

88 

V 

(86) 

118 

P 

(112) 

164 

F 

2 

(242) 

11 

V 

T 

(11) 

63 

0 

(64) 

89 

W 

(87) 

119 

q 

(113) 

165 

F 

3 

(243) 

12 

F F 

(12) 

64 

A 

(65) 

90 

X 

(88) 

120 

r 

(114) 

166 

F 

4 

(244) 

13 

c 

R 

(13) 

64 

A 

(161) 

91 

Y 

(89) 

121 

s 

(115) 

167 

0 

(245) 

14 

fi 

0 

(14) 

64 

A 

(162) 

91 

Y 

(238) 

121 

li 

(222) 

168 

c 

L 

(128) 

15 


(15) 

64 

A 

(208) 

92 

z 

(90) 

122 

§ 

(236) 

169 

I 

U 

(129) 

16 

0 

L 

(16) 

64 

A 

(211) 

93 

B (240) 

123 

t 

(116) 

170 

B 

G 

(130) 

17 


(17) 

64 

A 

(216) 

94 

[ 

(91) 

124 

u 

(117) 

171 

I 

B 

(131) 

18 


(18) 

64 

A 

(224) 

95 

\ 

(92) 

124 

Q 

(195) 

172 

U 

JL 

(132) 

19 


(19) 

64 

A 

(225) 

96 

] 

(93) 

124 

0 

(199) 

173 

I 

(133) 

20 

°4 

(20) 

65 

B 

(66) 

97 


(94) 

124 

Ci 

(203) 

174 

B 

-G 

(134) 

21 

N 

K 

(21) 

66 

C 

(67) 

98 


(95) 

124 

a 

(207) 

175 

I 

£ 

(135) 

22 

S 

Y 

(22) 

66 

C 

(180) 

99 


(96) 

125 

V 

(118) 

176 

W 

H 

(136) 

23 

E 

B 

(23) 

67 

D 

(68) 

100 

a 

(97) 

126 

w 

(119) 

177 

R 

D 

(137) 

24 

C 

N 

(24) 

68 

D 

(227) 

100 

ft 

(192) 

127 

X 

(120) 

178 

Y 

E 

(138) 

25 

E 

M 

(25) 

69 

E 

(69) 

100 

ft 

(196) 

128 

y 

(121) 

179 

G 

R 

(139) 

26 

S 

B 

(26) 

69 

ft 

(163) 

100 

k 

(200) 

128 

y 

(239) 

180 

C 

Y 

(140) 

27 

E 

C 

(27) 

69 

ft 

(164) 

100 

a 

(204) 

129 

z 

(122) 

181 

B 

U 

(141) 

28 


(28) 

69 

ft 

(165) 

100 

a 

(212) 

130 


(241) 

182 

M 

G 

(142) 

29 

1 

(29) 

69 

ft 

(220) 

100 

£ 

(215) 

131 

{ 

(123) 

183 

B 

K 

(143) 

30 

R 

5 

(30) 

70 

F 

(70) 

100 

a 

(226) 

132 

1 

(124) 

184 

9 

0 

(144) 

31 

% 

(31) 

71 

G 

(71) 

101 

b 

(98) 

133 

} 

(125) 

185 

9 

1 

(145) 

32 


(32) 

72 

H 

(72) 

102 

c 

(99) 

134 

- 

(126) 

186 

9 

2 

(146) 

33 

t 

(33) 

73 

I 

(73) 

103 

? 

(181) 

135 


(168) 

187 

9 

3 

(147) 

34 

" 

(34) 

73 

± 

(166) 

104 

d 

(100) 

136 

' 

(169) 

188 

9 

a 

(148) 

35 

# 

(35) 

73 

X 

(167) 

105 

d 

(228) 

137 


(170) 

189 

9 

5 

(149) 

36 

$ 

(36) 

73 

± 

(229) 

106 

e 

(101) 

138 


(171) 

190 

9 

8 

(150) 

37 

% 

(37) 

73 

± 

(230) 

106 

ft 

(193) 

139 


(172) 

191 

9 

7 

(151) 

38 

& 

(38) 

74 

J 

(74) 

106 

ft 

(197) 

140 

£ 

(175) 

192 

9 

8 

(152) 

39 

1 

(39) 

75 

K 

(75) 

106 

ft 

(201) 

141 


(176) 

193 

9 

9 

(153) 

40 

( 

(40) 

76 

L 

(76) 

106 

ft 

(205) 

142 


(179) 

194 

9 

A 

(154) 

41 

) 

(41) 

77 

M 

(77) 

107 

f 

(102) 

143 

ft 

(184) 

195 

9 

B 

(155) 

42 

* 

(42) 

78 

N 

(78) 

108 

g 

(103) 

144 

<L 

(185) 

196 

9 

C 

(156) 

43 

+ 

(43) 

79 

fl 

(182) 

109 

h 

(104) 

145 

a 

(186) 

197 

9 

D 

(157) 

44 

> 

(44) 

80 

0 

(79) 

110 

i 

(105) 

146 

£ 

(187) 

198 

9 

E 

(158) 

45 


(46) 

80 

0 

(210) 

110 

1 

(209) 

147 

V 

(188) 

199 

9 

F 

(159) 

46 

/ 

(47) 

80 

o 

(218) 

110 

i 

(213) 

148 

i 

(189) 

200 

H 

(255) 

47 

0 

(48) 

80 

6 

(223) 

110 

1 

(217) 

149 

/ 

(190) 




48 

1 

(49) 

80 

6 

(231) 

110 

i 

(221) 

150 

e 

(191) 




49 

2 

(50) 

80 

6 

(232) 

111 

3 

(106) 

151 

- 

(246) 




50 

3 

(51) 

80 

a 

(233) 

112 

k 

(107) 

152 

£ 

(247) 





Useful Tables 4-19 


LEXICAL ORDER IS GERMAN 


Seq. 

Chr. 

Nun. 

Seq, 

Chr . Nun . 

Seq. 

Chr 

Nam. 

Seq. 

Chr . Nam . 

Seq. 

Chr. Nam. 

0 

N 

U 

(0) 

52 

4 

(52) 

102 

P 

(80) 

152 

1 

(108) 

201 


(248) 

1 

s 

H 

(1) 

53 

5 

(53) 

103 

Q 

(81) 

153 

in 

(109) 

202 

1 

(249) 

2 

B x 

(2) 

54 

6 

(54) 

104 

R 

(82) 

154 

n 

(110) 

203 

£ 

(250) 

3 

E x 

(3) 

55 

7 

(55) 

105 

S 

(83) 

155 

Pi 

(183) 

204 

« 

(251) 

4 

\ 

(4) 

56 

8 

(56) 

106 

§ 

(235) 

156 

o 

(111) 

205 

■ 

(252) 

5 

E o 

(5) 

57 

9 

(57) 

107 

T 

(84) 

156 

6 

(206) 

206 


(253) 

6 

R 

K 

(6) 

58 

: 

(58) 

108 

U 

(85) 

157 

6 

(198) 

207 

± 

(254) 

7 

0 

(7) 

59 

j 

(59) 

108 

0 

(219) 

158 

6 

(202) 

208 

1 

(127) 

8 

B 

S 

(8) 

60 

< 

(60) 

109 

0 

(237) 

159 

6 

(194) 

209 


(160) 

9 

H 

T 

(9) 

61 

s 

(61) 

110 

0 

(173) 

160 

8 

(234) 

210 

B 

1 

(177) 

10 

L 

F 

(10) 

62 

> 

(62) 

111 

0 

(174) 

161 

0 

(214) 

211 

B 

2 

(178) 

11 

V 

T 

(11) 

63 

? 

(63) 

112 

V 

(86) 

162 

P 

(112) 

212 

F 

2 

(242) 

12 

f r 

(12) 

64 

@ 

(64) 

113 

Vi 

(87) 

163 

q 

(113) 

213 

F 

3 

(243) 

13 

C 

R 

(13) 

65 

A 

(65) 

114 

X 

(88) 

164 

r 

(114) 

214 

F 

a 

(244) 

14 

* 

(14) 

65 

A 

(216) 

115 

y 

(89) 

165 

s 

(115) 

215 

i 

0 

(245) 

15 

S 

X 

(15) 

66 

A. 

(211) 

116 

Y 

(238) 

165 

6 

(222) 

216 

c 

L 

(128) 

16 

D 

L 

(16) 

67 

A 

(208) 

117 

z 

(90) 

166 

§ 

(236) 

217 

I 

V 

(129) 

17 

D i 

(17) 

68 

A 

(224) 

118 

* 

(240) 

167 

t 

(116) 

218 

B 

G 

(130) 

18 

* 

(18) 

69 

A 

(161) 

119 

[ 

(91) 

168 

U 

(117) 

219 

I 

B 

(131) 

19 

% 

(19) 

70 

A 

(162) 

120 

\ 

(92) 

168 

u 

(207) 

220 

U 

L 

(132) 

20 

°A 

(20) 

71 

A 

(225) 

121 

] 

(93) 

169 

u 

(199) 

221 

I 

J*! 

(133) 

21 

N 

K 

(21) 

72 

B 

(66) 

122 


(94) 

170 

Ci 

(203) 

222 

B 

£ 

(134) 

22 

S 

Y 

(22) 

73 

C 

(67) 

123 


(95) 

171 

Q 

(195) 

223 

I 

£ 

(135) 

23 

E 

B 

(23) 

74 

Q 

(180) 

124 

' 

(96) 

172 

V 

(118) 

224 

w 

H 

(136) 

24 

C 

N 

(24) 

75 

D 

(68) 

125 

a 

(97) 

173 

w 

(119) 

225 

R 

D 

(137) 

25 

E 

M 

(25) 

76 

D 

(227) 

125 

a 

(204) 

174 

X 

(120) 

226 

Y 

E 

(138) 

26 

1 

(26) 

77 

E 

(69) 

126 

£ 

(215) 

175 

y 

(121) 

227 

G 

R 

(139) 

27 

E 

C 

(27) 

78 

& 

(220) 

127 

a 

(212) 

176 

y 

(239) 

228 

C 

Y 

(140) 

28 

F 5 

(28) 

79 

t 

(163) 

128 

& 

(196) 

177 

z 

(122) 

229 

B 

U 

(141) 

29 

1 

(29) 

80 

t 

(164) 

129 

A 

(200) 

178 


(241) 

230 

M 

G 

(142) 

30 

R 

5 

(30) 

81 

E 

(165) 

130 

a 

(192) 

179 

i 

(123) 

231 

B 

K 

(143) 

31 

'i 

(31) 

82 

F 

(70) 

131 

a 

(226) 

180 

1 

(124) 

232 

9 

0 

(144) 

32 


(32) 

83 

G 

(71) 

132 

b 

(98) 

181 

> 

(125) 

233 

9 

1 

(145) 

33 

; 

(33) 

84 

H 

(72) 

133 

c 

(99) 

182 

- 

(126) 

234 

9 

2 

(146) 

34 

H 

(34) 

85 

I 

(73) 

134 

<? 

(181) 

183 

* 

(168) 

235 

9 

3 

(147) 

35 

# 

(35) 

86 

± 

(229) 

135 

d 

(100) 

184 


(169) 

236 

9 

a 

(148) 

36 

$ 

(36) 

87 

± 

(230) 

136 

d 

(228) 

185 

* 

(170) 

237 

9 

5 

(149) 

37 

% 

(37) 

88 

± 

(166) 

137 

e 

(101) 

186 


(171) 

238 

9 

6 

(150) 

38 

& 

(38) 

89 

X 

(167) 

138 

6 

(197) 

187 


(172) 

239 

9 

7 

(151) 

39 

• 

(39) 

90 

J 

(74) 

139 

4 

(201) 

188 

€ 

(175) 

240 

9 

8 

(152) 

40 

( 

(40) 

91 

K 

(75) 

140 

a 

(193) 

189 


(176) 

241 

9 

9 

(153) 

41 

) 

(41) 

92 

L 

(76) 

141 

e 

(205) 

190 


(179) 

242 

9 

A 

(154) 

42 

* 

(42) 

93 

M 

(77) 

142 

f 

(102) 

191 

i 

(184) 

243 

9 

B 

(155) 

43 

+ 

(43) 

94 

N 

(78) 

143 

g 

(103) 

192 

L 

(185) 

244 

9 

C 

(156) 

44 

> 

(44) 

95 

R 

(182) 

144 

h 

(104) 

193 

a 

(186) 

245 

9 

D 

(157) 

45 


(45) 

96 

0 

(79) 

145 

i 

(105) 

194 

£ 

(187) 

246 

9 

E 

(158) 

46 


(46) 

96 

o 

(218) 

146 

1 

(213) 

195 

¥ 

(188) 

247 

9 

F 

(159) 

47 

/ 

(47) 

97 

d 

(231) 

147 

1 

(217) 

196 

1 

(189) 

248 

Q 

(255) 

48 

0 

(48) 

98 

d 

(232) 

148 

i 

(209) 

197 

/ 

(190) 




49 

1 

(49) 

99 

d 

(223) 

149 

i 

(221) 

198 

c 

(191) 




50 

2 

(50) 

100 

e 

(233) 

150 

j 

(106) 

199 

- 

(246) 




51 

3 

(51) 

101 

0 

(210) 

151 

k 

(107) 

200 

i 

(247) 





4-20 Useful Tables 


LEXICAL ORDER IS SPANISH 


Seq. 

Chr, 

Nam. 

Seq. 

Chr 

. Num. 

Seq. 

Chr 

Nam, 

Seq. 

Chr. Nam. 

Seq. 

Chr. Nam. 

0 

N 

U 

(0) 

52 

4 

(52) 

84 

P 

(80) 

116 

1 

(108) 

157 

1 

(248) 

1 

5 

H 

(1) 

53 

5 

(53) 

85 

Q 

(81) 

118 

m 

(109) 

158 

A. 

(249) 

2 

S 

X 

(2) 

54 

6 

(54) 

86 

R 

(82) 

119 

n 

(110) 

159 

& 

(250) 

3 

E 

(3) 

55 

7 

(55) 

87 

S 

(83) 

120 

ft 

(183) 

160 

« 

(251) 

4 

S 

(4) 

56 

8 

(56) 

88 

§ 

(235) 

121 

0 

(111) 

161 

■ 

(252) 

5 

E o 

(5) 

57 

9 

(57) 

89 

T 

(84) 

121 

6 

(194) 

162 

» 

(253) 

6 

A 

V. 

(6) 

58 

: 

(58) 

90 

U 

(85) 

121 

6 

(198) 

163 

± 

(254) 

7 

0 

(7) 

59 

i 

(59) 

90 

0 

(173) 

121 

6 

(202) 

164 

« 

(127) 

8 

B 

5 

(8) 

60 

< 

(60) 

90 

0 

(174) 

121 

6 

(206) 

165 


(160) 

9 

H 

T 

(9) 

61 

. 

(61) 

90 

u 

(219) 

121 

0 

(214) 

166 

B 

1 

(177) 

10 

L 

F 

(10) 

62 

> 

(62) 

90 

0 

(237) 

121 

8 

(234) 

167 

B 

2 

(178) 

11 

T 

(11) 

63 

? 

(63) 

91 

V 

(86) 

122 

P 

(112) 

168 

F 

2 

(242) 

12 

F r 

(12) 

64 

@ 

(64) 

92 

w 

(87) 

123 

q 

(113) 

169 

F 

3 

(243) 

13 

C 

R 

(13) 

65 

A 

(65) 

93 

X 

(88) 

124 

r 

(114) 

170 

F 

a 

(244) 

14 

% 

(14) 

65 

A 

(161) 

94 

Y 

(89) 

125 

s 

(115) 

171 

i 

□ 

(245) 

15 

S 

T 

(15) 

65 

A 

(162) 

94 

Y 

(238) 

125 

13 

(222) 

172 

c 

L 

(128) 

16 

D 

l 

(16) 

65 

A 

(208) 

95 

z 

(90) 

126 

§ 

(236) 

173 

I 

U 

(129) 

17 

D i 

(17) 

65 

A 

(211) 

96 

£ 

(240) 

127 

t 

(116) 

174 

B 

G 

(130) 

18 

*4 

(18) 

65 

A 

(216) 

97 

[ 

(91) 

128 

u 

(117) 

175 

I 

B 

(131) 

19 

% 

(19) 

65 

A 

(224) 

98 

\ 

(92) 

128 

Q 

(195) 

176 

U 

i- 

(132) 

20 

°4 

(20) 

65 

A 

(225) 

99 

3 

(93) 

128 

0 

(199) 

177 

I 

II 

(133) 

21 

N 

K 

(21) 

66 

B 

(66) 

100 

* 

(94) 

128 

Ci 

(203) 

178 

B 

£ 

(134) 

22 

S 

Y 

(22) 

67 

C 

(67) 

101 


(95) 

128 

u 

(207) 

179 

I 

£ 

(135) 

23 

% 

(23) 

67 

g 

(180) 

102 

' 

(96) 

129 

V 

(118) 

180 

W 

H 

(136) 

24 

C N 

(24) 

69 

D 

(68) 

103 

a 

(97) 

130 

w 

(119) 

181 

R 

D 

(137) 

25 

E 

M 

(25) 

70 

D 

(227) 

103 

A 

(192) 

131 

X 

(120) 

182 

Y 

E 

(138) 

26 

5 

B 

(26) 

71 

E 

(69) 

103 

k 

(196) 

132 

y 

(121) 

183 

G 

R 

(139) 

27 

E 

c 

(27) 

71 

£ 

(163) 

103 

k 

(200) 

132 

y 

(239) 

184 

C 

Y 

(140) 

28 

F s 

(28) 

71 

£ 

(164) 

103 

a 

(204) 

133 

z 

(122) 

185 

B 

U 

(141) 

29 

% 

(29) 

71 

E 

(165) 

103 

a 

(212) 

134 


(241) 

186 

M 

G 

(142) 

30 

R 

S 

(30) 

71 

£ 

(220) 

103 

ae 

(215) 

135 

{ 

(123) 

187 

B 

K 

(143) 

31 

% 

(31) 

72 

F 

(70) 

103 

a 

(226) 

136 

I 

(124) 

188 

9 

0 

(144) 

32 


(32) 

73 

G 

(71) 

104 

b 

(98) 

137 

> 

(125) 

189 

9 

1 

(145) 

33 

i 

(33) 

74 

H 

(72) 

105 

c 

(99) 

138 

- 

(126) 

190 

9 

2 

(146) 

34 

» 

(34) 

75 

I 

(73) 

105 

P 

(181) 

139 

* 

(168) 

191 

9 

3 

(147) 

35 

# 

(35) 

75 

± 

(166) 

107 

d 

(100) 

140 


(169) 

192 

9 

a 

(148) 

36 

$ 

(36) 

75 

X 

(167) 

108 

d 

(228) 

141 


(170) 

193 

9 

5 

(149) 

37 

% 

(37) 

75 

± 

(229) 

109 

e 

(101) 

142 

“ 

(171) 

194 

9 

6 

(150) 

38 

& 

(38) 

75 

± 

(230) 

109 

g 

(193) 

143 


(172) 

195 

9 

7 

(151) 

39 

• 

(39) 

76 

J 

(74) 

109 

£ 

(197) 

144 

£ 

(175) 

196 

9 

8 

(152) 

40 

( 

(40) 

77 

K 

(75) 

109 


(201) 

145 

~ 

(176) 

197 

9 

9 

(153) 

41 

) 

(41) 

78 

L 

(76) 

109 

e 

(205) 

146 


(179) 

198 

9 

A 

(154) 

42 

* 

(42) 

80 

M 

(77) 

110 

f 

(102) 

147 

i 

(184) 

199 

9 

B 

(155) 

43 

+ 

(43) 

81 

N 

(78) 

111 

g 

(103) 

148 

l 

(185) 

200 

9 

C 

(156) 

44 


(44) 

82 

A 

(182) 

112 

h 

(104) 

149 

h 

(186) 

201 

9 

D 

(157) 

45 

- 

(45) 

83 

0 

(79) 

113 

i 

(105) 

150 

£ 

(187) 

202 

9 

E 

(158) 

46 


(46) 

83 

0 

(210) 

113 

1 

(209) 

151 

¥ 

(188) 

203 

9 

F 

(159) 

47 

/ 

(47) 

83 

6 

(218) 

113 

i 

(213) 

152 

i 

(189) 

204 

B 

(255) 

48 

0 

(48) 

83 

6 

(223) 

113 

1 

(217) 

153 

/ 

(190) 




49 

1 

(49) 

83 

6 

(231) 

113 

i 

(221) 

154 

c 

(191) 




50 

2 

(50) 

83 

<b 

(232) 

114 

j 

(106) 

155 

- 

(246) 




51 

3 

(51) 

83 

e 

(233) 

115 

k 

(107) 

156 

i 

(247) 
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LEXICAL ORDER IS SWEDISH 


Seq. 

Chr 

Hum, 

Seq. 

Chr 

Num. 

Seq. 

Chr 

Num. 

Seq. 

Chr . Num, 

Seq. 

Chr . Num. 

0 

N 

U 

(0) 

52 

4 

(52) 

104 

t 

(229) 

154 

X 

(215) 

206 

h 

(248) 

1 

5 

W 

(1) 

53 

5 

(53) 

105 

t 

(230) 

155 

a 

(212) 

207 

1 

(249) 

2 

s 

X 

(2) 

54 

6 

(54) 

106 

± 

(166) 

156 

A 

(196) 

208 

& 

(250) 

3 

E 

X 

(3) 

55 

7 

(55) 

107 

± 

(167) 

157 

A 

(200) 

209 

« 

(251) 

4 

E t 

(4) 

56 

8 

(56) 

108 

R 

(182) 

158 

a 

(192) 

210 

■ 

(252) 

5 

% 

(5) 

57 

9 

(57) 

109 

6 

(231) 

159 

a 

(204) 

211 

» 

(253) 

6 

f) 

K 

(6) 

58 

: 

(58) 

110 

<b 

(232) 

160 

a 

(226) 

212 

± 

(254) 

7 

0 

(7) 

59 

! 

(59) 

111 

6 

(223) 

161 

c 

(181) 

213 

* 

(127) 

8 

% 

(8) 

60 

< 

(60) 

112 

6 

(218) 

162 

d 

(228) 

214 


(160) 

9 

H 

T 

(9) 

61 


(61) 

113 

0 

(233) 

163 

4 

(201) 

215 

B 

1 

(177) 

10 

L 

r 

(10) 

62 

> 

(62) 

114 

0 

(210) 

164 

& 

(193) 

216 

B 

2 

(178) 

11 

V 

T 

(11) 

63 

? 

(63) 

115 

§ 

(235) 

165 

e 

(205) 

217 

F 

2 

(242) 

12 

r F 

(12) 

64 

0 

(64) 

116 

0 

(237) 

166 

1 

(213) 

218 

F 

3 

(243) 

13 

c 

R 

(13) 

65 

A 

(65) 

117 

u 

(173) 

167 

1 

(217) 

219 

F 

a 

(244) 

14 

s 

0 

(14) 

66 

B 

(66) 

118 

0 

(174) 

168 

i 

(209) 

220 

i 

0 

(245) 

15 

s 

I 

(15) 

67 

C 

(67) 

119 

0 

(219) 

169 

i 

(221) 

221 

c 

L 

(128) 

16 

D 

t 

(16) 

68 

D 

(68) 

120 

Y 

(238) 

170 

n 

(183) 

222 

I 

V 

(129) 

17 


(17) 

69 

E 

(69) 

121 

£ 

(240) 

171 

6 

(198) 

223 

B 

G 

(130) 

18 


(18) 

70 

F 

(70) 

122 

[ 

(91) 

172 

6 

(202) 

224 

I 

B 

(131) 

19 

s 

(19) 

71 

G 

(71) 

123 

\ 

(92) 

173 

6 

(194) 

225 

U 

L 

(132) 

20 


(20) 

72 

H 

(72) 

124 

] 

(93) 

174 

6 

(206) 

226 

I 

i! 

(133) 

21 

N 

K 

(21) 

73 

I 

(73) 

125 

* 

(94) 

175 

5 

(234) 

227 

B 

Si 

(134) 

22 

S 

Y 

(22) 

74 

J 

(74) 

126 


(95) 

176 

0 

(214) 

228 

I 

& 

(135) 

23 

% 

(23) 

75 

K 

(75) 

127 

' 

(96) 

177 

§ 

(236) 

229 

w 

H 

(136) 

24 

c 

N 

(24) 

76 

L 

(76) 

128 

a 

(97) 

178 

0 

(199) 

230 

R 

D 

(137) 

25 

f. 

(25) 

77 

M 

(77) 

129 

b 

(98) 

179 

0 

(203) 

231 

Y 

E 

(138) 

26 

1 

(26) 

78 

N 

(78) 

130 

c 

(99) 

180 

Q 

(195) 

232 

G 

R 

(139) 

27 

6 c 

(27) 

79 

0 

(79) 

131 

d 

(100) 

181 

ii 

(207) 

233 

C 

Y 

(140) 

28 


(28) 

80 

P 

(80) 

132 

e 

(101) 

182 

y 

(239) 

234 

B 

U 

(141) 

29 

% 

(29) 

81 

0 

(81) 

132 

6 

(197) 

183 


(241) 

235 

M 

G 

(142) 

30 

R 

S 

(30) 

82 

p 

(82) 

133 

f 

(102) 

184 

{ 

(123) 

236 

B 

K 

(143) 

31 

u 

s 

(31) 

83 

s 

(83) 

134 

g 

(103) 

185 

i 

(124) 

237 

9 

0 

(144) 

32 


(32) 

84 

T 

(84) 

135 

h 

(104) 

186 

> 

(125) 

238 

9 

1 

(145) 

33 

1 

(33) 

85 

U 

(85) 

136 

i 

(105) 

187 

- 

(126) 

239 

9 

2 

(146) 

34 

" 

(34) 

86 

V 

(86) 

137 

j 

(106) 

188 


(168) 

240 

9 

3 

(147) 

35 

# 

(35) 

87 

W 

(87) 

138 

k 

(107) 

189 


(169) 

241 

9 

a 

(148) 

36 

$ 

(36) 

88 

X 

(88) 

139 

1 

(108) 

190 


(170) 

242 

9 

5 

(149) 

37 

% 

(37) 

89 

Y 

(89) 

140 

m 

(109) 

191 


(171) 

243 

9 

6 

(150) 

38 

& 

(38) 

90 

Z 

(90) 

141 

n 

(110) 

192 

' w 

(172) 

244 

9 

7 

(151) 

39 

• 

(39) 

91 

A 

(211) 

142 

0 

(111) 

193 

£ 

(175) 

245 

9 

8 

(152) 

40 

( 

(40) 

92 

A 

(208) 

143 

P 

(112) 

194 

“ 

(176) 

246 

9 

9 

(153) 

41 

) 

(41) 

93 

A 

(224) 

144 

q 

(113) 

195 


(179) 

247 

9 

A 

(154) 

42 

* 

(42) 

94 

A 

(161) 

145 

r 

(114) 

196 

i 

(184) 

248 

9 

B 

(155) 

43 

+ 

(43) 

95 

A 

(162) 

146 

s 

(115) 

197 

i 

(185) 

249 

9 

C 

(156) 

44 

> 

(44) 

96 

A 

(216) 

146 

3 

(222) 

198 

B 

(186) 

250 

9 

D 

(157) 

45 


(45) 

97 

A 

(225) 

147 

t 

(116) 

199 

£ 

(187) 

251 

9 

E 

(158) 

46 


(46) 

98 

Q 

(180) 

148 

u 

(117) 

200 

V 

(188) 

252 

9 

F 

(159) 

47 

/ 

(47) 

99 

D 

(227) 

149 

V 

(118) 

201 

§ 

(189) 

253 

a 

(255) 

48 

0 

(48) 

100 

£ 

(220) 

150 

w 

(119) 

202 

i 

(190) 




49 

1 

(49) 

101 

£ 

(163) 

151 

X 

(120) 

203 

c 

(191) 




50 

2 

(50) 

102 

t 

(164) 

152 

y 

(121) 

204 

- 

(246) 




51 

3 

(51) 

103 

E 

(165) 

153 

z 

(122) 

205 

* 

(247) 
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Master Reset Table 


(/> (fi 



Power 

On 

SCRATCH A 

SCRATCH 

SCRATCH C 

RESET 

Note 2 

END/ 

STOP 

LOAD 

LOAD 

&Go 

GET 

GET 

&Go 

LOADSUB 

Main 

Prerun 

SUB 

Entry 

SUB 

Exit 

CRT 

CRT DISP Line 

Clear 

Clear 



Clear 










CRT Display Functions 

Off 

Off 

- 

- 

- 

- 

- 

- 

- 

- 

- 

- 

- 

- 

CRT Message Line 

Ready 

Clear 

Clear 

Clear 

Reset 

- 

- 

- 

- 

- 

- 

Clear 

- 

- 

CRT Input Line (Note 6) 

Clear 

Clear 

Clear 

- 

Clear 

- 

- 

- 

- 

- 

- 

- 

- 

- 

CRT Printout Area 

Clear 

Clear 

- 

- 

- 

- 

- 

- 

- 

- 

- 

- 

- 

- 

CRT Print Position (TABXY) 

1,1 

1,1 

- 

- 

Note IS 

- 

- 

- 

- 

- 

- 

- 

- 

- 

ALPHA ON/OFF (Note 3) 

On 

On 

On 

On 

On 

On 

- 

- 

- 

- 

- 

- 

- 

- 

KEYBOARD 

Keyboard Recall Buffer 

Clear 














Keyboard Result Buffer 

Empty 

Empty 

- 

- 

- 

- 

- 

- 

- 

- 

- 

- 

- 

- 

Tabs On Input Line 

None 

None 

- 

- 

- 

- 

- 

- 

- 

- 

- 

- 

- 

- 

Typing Aid Labels 

Note 16 

Note 16 

- 

- 

- 

- 

- 

- 

- 

- 

- 

- 

- 

- 

Keyboard Katakana Mode 

Off 

Off 

Off 

- 

Off 

- 

- 

- 

- 

- 

- 

- 

- 

- 

SUSPEND INTERACTIVE 

Off 

Off 

Off 

Off 

Off 

Off 

Off 

Off 

Off 

Off 

- 

Off 

- 

- 

PRINTING 

Print column 

1 

1 



1 










PRINTALL 

Off 

Off 

- 

_ 

Off 

- 

- 

- 

- 

- 

- 

— 

— 

— 

PRINTALL IS 

1 

1 

- 

- 

- 

- 

- 

- 

- 

— 

— 

— 

— 

— 

PRINTER IS 

1 

1 

— 

— 

— 

— 

— 

- 

- 

— 

— 

— 

— 

— 

ENVIRONMENTS & VARIABLES 

Allocated Variables 

None 

None 

None 

None 

Note 1 

Note 1 

None 

None 

None 

None 


None 

None 

Pre-ent 

Normal Variables 

None 

None 

None 

None 

- 

- 

None 

None 

None 

None 

- 

Note 11 

Note 11 

Pre-ent 

COM Variables 

None 

None 

- 

None 

- 

- 

- 

Note 9 

- 

Note 9 

- 

- 

- 

- 

OPTION BASE 

0 

0 

0 

- 

- 

- 

- 

Note 9 

- 

Note 9 

- 

Note 9 

Note 9 

Pre-ent 

I/O Path Names 

None 

Closed 

Closed 

Closed 

None 

Closed 

Closed 

Closed 

Closed 

Closed 

- 

Closed 

- 

sub clsd 

I/O Path Names in COM 

None 

Closed 

- 

Closed 

None 

- 

Note 10 

Note 10 

Note 10 

Note 10 

- 

- 

- 

- 

Keyboard Variable Access 

No 

No 

No 

No 

Main 

Main 

No 

In cnt. 

No 

In cnt. 

In cnt. 

Main 

SUB 

Pre-ent 

BASIC Program Lines 

None 

None 

None 

- 

- 

- 

Note 4 

Note 4 

Note 4 

Note 4 

Note 4 

- 

- 

- 

BASIC Program Environment 

Main 

Main 

Main 

Main 

Main 

Main 

Main 

Main 

Main 

Main 

- 

Main 

SUB 

Pre-ent 

Normal Binary Programs 

None 

None 

- 

- 

- 

- 

Note 5 

Note 5 

- 

- 

- 

— 

- 

- 

SUB Stack 

Clear 

Clear 

Clear 

Clear 

Clear 

Clear 

Clear 

Clear 

Clear 

Clear 

- 

Clear 

Push 

Pop 

NPAR 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

- 

0 

Actual 

Pre-ent 

CONTINUE Allowed 

No 

No 

No 

No 

No 

No 

No 

Yes 

No 

Yes 

Yes 

Yes 

Yes 

Yes 

ON <event> ACTIONS 

ON <event> Log 

Empty 

Empty 

Empty 

Empty 

Empty 

Empty 

Empty 

Empty 

Empty 

Empty 


Empty 

Note 8 

Note 8 

System Priority 

0 

0 

0 

- 

- 

- 

- 

0 

- 

0 

- 

0 

Note 7 

Pre-ent 

ON KEY Labels 

None 

None 

None 

None 

None 

None 

None 

None 

None 

None 

- 

None 

- 

Pre-ent 

ENABLE/DISABLE 

Enable 

Enable 

Enable 

Enable 

Enable 

Enable 

Enable 

Enable 

Enable 

Enable 

- 

Enable 

- 

- 

KNOBX & KNOBY 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

- 

0 

- 

- 

ON EXT SIGNAL 

Dflt 

Dflt 

Dflt 


Dflt 

Dflt 

- 

- 

- 

- 

Dflt 

Dflt 

Note 8 

Note 8 


Note 20: For SRM files, RESET closes the file. For LIF and HFS files, RESET removes the I/O path name, but does not close 
the file. All other I/O path names at RESET are removed without any other action. 
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Power 

On 

SCRATCH A 

SCRATCH 

o 

5 

o 

I 

o 

RESET 

Note 2 

END/ 

STOP 

LOAD 

LOAD 

&Go 

GET 

GET 

&Go 

LOADSUB j 

Main 

Prerun 

SUB 

Entry 

SUB 

Exit 

MISC. 

GOSUB Stack 

Clear 

Clear 

Clear 

Clear 

Clear 

Clear 

Clear 

Clear 

Clear 

Clear 


Clear 

Local 

Pre-ent 

TIMEDATE 

Note 14 

- 

- 

- 

- 

- 

- 

- 

- 

- 

— 

— 

— 

— 

ERRL, ERRN, and ERRDS 

0 

0 

- 

- 

— 

- 

- 

0 

— 

0 

— 

0 

- 

— 

ERRM$ 

Null 

Null 

- 

- 

- 

- 

- 

Null 

- 

Null 

— 

Null 

- 

— 

DATA Pointer 

None 

None 

None 

None 

None 

None 

None 

1st main 

None 

1st main 

- 

1st main 

1st sub 

Pre-ent 

LEXICAL ORDER IS 

Stand. 

Stand. 

- 

- 

- 

- 

— 

- 

- 

- 

— 

— 

— 

— 

MASS STORAGE IS 

Note 12 

Note 12 

- 

- 

- 

- 

- 

- 

— 

- 

— 

— 

— 

— 

CHECKREAD ON/OFF 

Off 

Off 

— 

- 

- 

- 

- 

- 

— 

— 

— 

— 

— 

— 

Angle Mode 

RAD 

RAD 

RAD 

RAD 

- 

- 

RAD 

RAD 

RAD 

RAD 

- 

RAD 

- 

Pre-ent 

Random Number Seed 

Note 13 

Note 13 

Note 13 

- 

- 

- 

- 

Note 13 

- 

Note 13 

- 

Note 13 

- 

— 

DET 

0 

0 

0 

- 

- 

- 

- 

- 

- 

- 

- 

0 

- 

— 

TRANSFER 

None 

Aborts 

Note 17 

Waits 

Aborts 

Waits 

None 

Note 18 

None 

Waits 

— 

None 

- 

Note 19 

TRACE ALL 

Off 

Off 

Off 

- 

- 

- 

- 

- 

- 

- 

— 

— 

— 

— 

Wildcards 

Off 

Off 

- 

- 

_ 

- 

- 

- 

- 

- 

— 

- 

- 

— 


— = Unchanged 

Pre-ent = As existed previous to entry into the subprogram. 

In cnt. = Access to variables in current context only. 

1st main = Pointer set to first DATA statement in main program. 

1st sub = Pointer set to first DATA statement in subprogram, 
sub clsd = All local I/O path names are closed at subexit. 

Waits = Operation waits until TRANSFER completes. 

Note 1: Only those allocated in the main program are available. 

Note 2: Pressing the STOP key is identical in function to executing STOP. Editing or altering a paused program causes the program to go 
into the stopped state. 

Note 3: Alpha is turned on automatically by typing on the input line, by writing to the display line, or by an output to the message line. 
Note 4: Modified according to the statement or command parameters and file contents. 

Note 5: Any new binary programs in the file are loaded. 

Note 6: Includes cursor position, INS CHR mode, ANY CHAR sequence state, but not tabs, auto-repeat rate, and auto-repeat delay. 
(These last three are defaulted only at SCRATCH A and Power On.) 

Note 7: The system priority changes at SUB entry if the subroutine was invoked by an ON <event> CALL. 

Note 8: See the appropriate keyword. 

Note 9: As specified by the new environment or program. 

Note 10: A COM mismatch between programs will close I/O path names. If I/O path names exist in a labeled COM. and a LOAD or GET 
brings in a program which does not contain that labeled COM, those I/O path names are closed. 

Note 11: Numeric variables are set to 0, and string lengths are set to 0. 

Note 12: The default mass storage device is INTERNAL (the right-hand drive) on the 9826 and 9836. See the 9816 Installation Manual foi 
information on its default mass storage device. 
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Further Comments 

Note 13: The default random number seed is INT(P1 x (2 31 — 2)/180). This is equal to 37 480 660. 

Note 14: The default TIMEDATE is 2.086 629 12 E+ 11 (midnight March 1, 1900, Julian time). 

Note 15: After a RESET, the CRT print position is in column one of the next line below the print position before the RESET. 

Note 16: Typing aid labels are displayed unless a program is in the RUN state. 

Note 17: Operation waits until TRANSFER completes unless both I/O path names are in COM. 

Note 18: Operation waits until TRANSFER completes unless both I/O path names are in a COM area preserved during the LOAD. 
Note 19: Operation waits until TRANSFER completes if the TRANSFER uses a local I/O path name. 

The PAUSE key, the programmed PAUSE statement, and executing PAUSE from the keyboard all have identical effects. The only 
permanent effects of the sequence “PAUSE...CONTINUE” on a running program are: 

1. Delay in execution. 

2. Second and subsequent interrupt events of a given type are ignored. 

3. INPUT, LINPUT, and ENTER 2 statements will be restarted. 

4. ON KEY and ON KNOB are temporarily deactivated (i.e. not logged or executed) during the pause. 

5. A TRANSFER may complete during the pause, causing ON EOT to be serviced at the next end-of-line. 

Fatal program errors (i.e. those not trapped by ON ERROR) have the following effects: 

— a PAUSE 

— a beep 

— an error message in the message line 

— setting the values of t'ne ERRL, the ERRN, and possibly the ERRDS functions 

— setting the default EDIT line number to the number of the line in which the error occurred. 

Autostart is equivalent to: Power On, LOAD “AUTOST”, RUN. 

CLR IO terminates ENTER and OUTPUT on all interfaces, handshake setup operations, HP-IB control operations, DISP, ENTER 
from CRT or keyboard, CAT, LIST, external plotter output, and output to the PRINTER IS, PR1NTALL IS, and DUMP DEVICE IS 
devices when they are external. CLR IO does not terminate CONTROL, STATUS, READIO, WRITEIO, TRANSFER, real-time clock 
operations, mass storage operations (other than CAT), OUTPUT 2 (keyboard), or message line output. 

CLR IO clears any pending closure key action. 

If CLR IO is used to abort a DUMP GRAPHICS to an external device, the external device may be in the middle of an escape-code 
sequence. Thus, it might be counting characters to determine when to return to normal mode (from graphics mode). This means that a 
subsequent I/O operation to the same device may yield “strange” results. Handling this situation is the responsibility of the user and is 
beyond the scope of the firmware provided with the product. Sending 75 ASCII nulls is one way to “clear” the 9876 Graphics Printer. 
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Graphic Reset Table 



Power 

On 

5 

O 

I 

> 

SCRATCH 

5 

a 

X 

r> 

RESET 

Note 2 

END 

STOP 

GINIT 

Main 

Prerun 

PLOTTER IS 

CRT 

CRT 

_ 

_ 

CRT 

_ 

CRT 

_ 

Graphics Memory 

Clear 

Clear 

- 

- 

Note 1 

- 

Note 1 

- 

VIEWPORT 

hrd clip 

hrd clip 

- 

- 

hrd clip 

- 

hrd clip 

- 

X and Y Scaling (unit of measure) 

GDU 

GDU 

- 

- 

GDU 

- 

GDU 

- 

Soft Clip 

hrd clip 

hrd clip 

- 

- 

hrd clip 

- 

hrd clip 

- 

Current Clip 

hrd clip 

hrd clip 

- 

- 

hrd clip 

- 

hrd clip 

- 

CLIP ON'OFF 

Off 

Off 

- 

- 

Off 

- 

Off 

- 

PIVOT 

0 

0 

- 

- 

0 

- 

0 

- 

AREA PEN 

1 

1 

- 

~ 

1 

- 

1 

- 

PEN 

1 

1 

- 

— 

1 

- 

1 

— 

LINE TYPE 

1.5 

1.5 

- 

- 

1.5 

- 

1.5 

— 

Pen Position 

0.0 

0.0 

- 

- 

0.0 

- 

0.0 

— 

LORG 

1 

1 

- 

- 

1 

- 

1 

- 

CSIZE 

5.6 

5..6 

- 

- 

5.6 

- 

5.6 

- 

LDIR 

0 

0 

- 

- 

0 

- 

0 

- 

PDIR 

0 

0 

- 

- 

0 

- 

0 

- 

GRAPHICS ON OFF 

Off 

Off 

- 

- 

- 

- 

- 

- 

ALPHA ON OFF (Note 3) 

On 

On 

On 

On 

On 

On 

- 

- 

DUMP DEVICE IS 

701 

701 

- 

- 

- 

- 

- 

- 

GRAPHICS INPUT IS 

None 

None 

- 

- 

None 

- 

None 

- 

TRACK ... ON OFF 

Off 

Off 

- 

- 

Off 

_ 

Off 

- 

Color Map (Note 4) 

Off 

Off 

- 

- 

Note 5 

- 

Note 5 

- 

Drawing Mode 

Norm 

Norm 

— 

— 

Norm 

— 

Norm 

_ 


— = Unchanged 

hrd clip = The default hard clip boundaries of the CRT. 

Note 1: Although RESET leaves the graphics memory unchanged, it will be cleared upon execution of the next graphics statement that sets 
a default plotter following the RESET. 

Note 2: Pressing the STOP key is identical to executing STOP. Altering a paused program causes the program to go into the stopped state. 
Note 3: Alpha is turned on automatically by typing on the input line, by writing to the display line, or by an output to the message line. 
Note 4: With color map off, 8 standard colors are available. With color map on. 16 user-defined colors are available. See PLOTTER IS. 
Note 5: Although the color map remains unchanged, it is changed if a graphics statement selects the device as a default plotter. 
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Interface Reset Table 



Power 

On 

5 

F) 

X 

> 

SCRATCH 

BASIC 

RESET 

Note 5 

END/ 

STOP 

LOAD 

GET 

Note 6 

Reset 

Cmd 

Main 

Prerun 

SUB 

Entry 

SUB 

Exit 

CLR 

I/O 

GPIO Card 

Interrupt Enable Bit 

Clear 

Clear 

Clear 

Clear 

Clear 

Clear 

Clear 

Clear 

Clear 




Active Timeout Counter 

Clear 

Clear 

Clear 

Clear 

Clear 

Clear 

Clear 

- 

Clear 

- 

- 

- 

Enable Interrupt Mask 

Clear 

Clear 

Clear 

Clear 

Clear 

Clear 

Clear 

Clear 

Clear 

- 

- 

- 

Hardware Reset of Card (PRESET) 

Reset 

Note 1 

Note 1 

Reset 

Note 1 

Note 1 

Note 1 

Reset 

Note 1 

- 

- 

Note 1 

PSTS Error Flag 

Clear 

Clear 

Clear 

Clear 

Clear 

Clear 

Clear 

Clear 

Clear 

- 

- 

- 

RS-232 Card 

Interrupt Enable Bit 

Clear 

Clear 

Clear 

Clear 

Clear 

Clear 

Clear 

Clear 

Clear 




Active Timeout Counter 

Clear 

Clear 

Clear 

Clear 

Clear 

Clear 

Clear 

- 

Clear 

- 

- 

- 

Enable Interrupt Mask 

Clear 

Clear 

Clear 

Clear 

Clear 

Clear 

Clear 

Clear 

Clear 

- 

- 

- 

Hardware Reset of Card 

Reset 

Reset 

- 

Reset 

- 

- 

- 

Reset 

- 

- 

- 

- 

Data Rate/Character Format 

Swtch 

Swtch 

— 

- 

- 

- 

- 

- 

- 

- 

- 

- 

RTS-DTR Latch 

Clear 

Clear 

- 

- 

- 

- 

- 

Clear 

- 

- 

~ 

- 

Request to Send Line 

Clear 

Clear 

- 

Clear 

- 

- 

- 

Clear 

- 

- 


Note 2 

Data Terminal Ready Line 

Clear 

Clear 

- 

Clear 

- 

- 

- 

Clear 

- 

- 

- 

Note 2 

Line Status Register 

Clear 

Clear 

Clear 

Clear 

Clear 

Clear 

Clear 

Clear 

Clear 

_ 

~ 

Clear 

Modem Status Register 

Clear 

Clear 

Clear 

Clear 

Clear 

Clear 

Clear 

Clear 

Clear 

- 


Clear 

Data-In Buffer 

Empty 

Empty 

Empty 

Empty 

Empty 

Empty 

Empty 

Empty 

Empty 

- 

- 

Empty 

Error-Pend. Rag 

Clear 

Clear 

Clear 

Clear 

Clear 

Clear 

Clear 

Clear 

Clear 

- 

_ 

Clear 

HP-IB 

Interrupt Enable Bit 

Clear 

Clear 

Clear 

Clear 

Clear 

Clear 

Clear 

Clear 

Clear 




Active Timeout Counter 

Clear 

Clear 

Clear 

Clear 

Clear 

Clear 

Clear 

- 

Clear 

- 

- 

- 

Interrupt Enable Mask 

Clear 

Clear 

Clear 

Clear 

Clear 

Clear 

Clear 

Clear 

Clear 

- 

- 

- 

User Interrupt Status 

Clear 

Clear 

Clear 

Clear 

Clear 

Clear 

Clear 

Clear 

Clear 

- 

- 

- 

Serial Poll Register 

Clear 

Clear 

- 

Clear 

- 

- 

- 

Clear 

- 

- 

- 

- 

Parallel Poll Register 

Clear 

Clear 

- 

Clear 

- 

- 

- 

Clear 

- 

- 

- 

- 

My Address Register 

Note 4 

Note 4 


~ 

- 

- 

- 

- 

- 

- 

- 

- 

IFC Sent 

Note 3 

Note 3 

- 

Note 3 

- 

- 

- 

Note 3 

- 

- 

- 

- 

REN Set True 

Note 3 

Note 3 

- 

Note 3 

- 

- 

- 

Note 3 

- 

- 

- 

- 

Data Communications 

Interrupt Enable Bit 

Clear 

Clear 

Clear 

Clear 

Clear 

Clear 

Clear 

Clear 

Clear 




Active Timeout Counter 

Clear 

Clear 

Clear 

Clear 

Clear 

Clear 

Clear 

- 

Clear 

- 

- 

- 

interrupt Enable Mask 

Clear 

Clear 

Clear 

Clear 

Clear 

Clear 

Clear 

Clear 

Clear 

- 

- 

- 

Hardware Reset of Card 

Reset 

Note 7 

- 

Reset 

- 

- 

- 

Note 7 

- 

- 

- 

- 

Line State 

Dscon 

Dscor 

- 

Dscon 

- 


- 

Dscon 

- 

- 

- 

- 

Data Buffers 

Empty 

Empty 

- 

Empty 

- 

- 

- 

Empty 

- 

- 

- 

- 

Protocol Selection (Async or Data Link) 

Swtch 

Note 8 

- 

Swtch 

- 

- 

- 

Note 8 

- 


- 

- 

Protocol Options 

Swtch 

Swtch 

- 

Swtch 

- 

- 

- 

Swtch 

- 


- 

- 
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Power 

On 

5 

3 

X 

> 

SCRATCH 

BASIC 

RESET 

Note 5 

END/ 

STOP 

LOAD 

GET 

Note 6 

Reset 

Cmd 

Main 

Prerun 

SUB 

Entry 

SUB 

Exit 

CLR 

I/O 

BCD Card 

Interrupt Enable Bit 

Clear 

Clear 

Clear 

Clear 

Clear 

Clear 

Clear 

Clear 

Clear 




Active Timeout Counter 

Clear 

Clear 

Clear 

Clear 

Clear 

Clear 

Clear 

- 

Clear 

— 

— 

— 

Interrupt Enable Mask 

Clear 

Clear 

Clear 

Clear 

Clear 

Clear 

Clear 

Clear 

Clear 

— 

— 

_ 

Hardware Reset of Card 

Reset 

Note 1 

Note 1 

Note 1 

Note 1 

Note 1 

Note 1 

Reset 

Note 1 

- 

— 

Note 1 

Rewind Driver 

Rwd 

Rwd 

Rwd 

Rwd 

Rwd 

Rwd 

Rwd 

Rwd 

Rwd 

- 

— 

Rwd 

BCD/Binary Mode 

Swtch 

Swtch 

— 

_ 

_ 

_ 

_ 

__ 

_ 

_ 

_ 

_ 

EPROM Programmer 

Hardware Reset of Card 

Reset 

Reset 

_ 

Reset 

_ 

_ 

_ 

Reset 

_ 

_ 

_ 

__ 

Programming Time Register 

Clear 

Clear 

- 

- 

- 

- 

- 

Clear 

- 

- 

- 

- 

Target Address Register 

Clear 

Clear 

- 

- 

- 



Clear 

- 

- 

- 

- 


— = Unchanged 

Swtch = Set according to the switches on the interface card 
Dscon = A disconnect is performed 

Note 1: Reset only if card is not ready. 

Note 2: Cleared only if corresponding modem control line is not set. 

Note 3: Sent only if System Controller. 

Note 4: If System Controller and Active Controller, address is set to 21. Otherwise, it is set to 20. 

Note 5: Pressing the STOP key is identical in function to executing STOP or END. Editing or altering a paused program causes thi 

program to go into the stopped state. 

Note 6: Caused by sending a non-zero value to CONTROL register 0. 

Note 7: This is a “soft reset,” which does not include an interface self-test or a reconfiguration of protocol. 

Note 8: Set according to the value used in the most recent CONTROL statement directed to Register 3. If there has been n 

CONTROL 3 statement, the switch settings are used. 
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Second Byte of Non-ASCII Key Sequences (String) 


Holding the (ctrl) key and pressing a non-ASCII key generates a two-character 
sequence on the CRT. For example, 

(CTRL)- (a ear line ] 

produces the following characters on the CRT: 

K ’/, 

Non-ASCII keypresses can be simulated by outputting these two-byte 
sequences to the keyboard. For example, 

OUTPUT KBD;CHR$ (255); 

produces the same result as shown above. The decimal value of the first byte is 
255 (on some computers this is the “inverse-video” K). 

The following table can be used to look up the key that corresponds to the 
second character of the sequence. (On the small HP 98203A keyboard some 
non-ASCII keys generate ASCII characters when they are pressed while holding 
the (ctrlI key down.) 

Normally on an ITF keyboard, (?i) corresponds to ON KEY 1 ... , 
ff 2 ~) corresponds to ON KEY 2 ... , etc. However, you can use 
CONTROL KBD,14;1 to change this relationship so that (a) corresponds to 
ON KEY 0 ... , (?2) corresponds to ON KEY 1 ... , etc. 

With 98203 keyboard compatibility (KBD CMODE ON), the ITF keyboard 
softkeys (fi) thru (m}, the (Menu 1 and (System 1 keys, and (fT) thru (fi} correspond 
to 98203 softkeys fkcT) thru fkT) , respectively. See “Porting to Series 300” 
chapter of HP BASIC 6.2 Porting and Globalization for further information 
about this mode. 

The terms System and User in the ITF Key column refer to the softkey menu 
which is currently active on an ITF keyboard. 
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Char. 

Val. 

ITF 

Key 

98203 

Key 

Closure 

Key 

space 

32 

l 

l 


i 

33 

[Shift H Stop] 


Yes 

II 

34 

1 

i 


# 

35 


[CLR LN] 


$ 

36 

System (fT) 

[ANY CHAR] 

Yes 

*/. 

37 

[Clear line ] 

[CLR—>-END) 

Yes 

ft 

38 


2 


> 

39 


2 

Yes 

( 

40 




) 

41 


1 


* 

42 

(Insert line ] 

[INS LN] 

Yes 

+ 

43 

[Insert char] 

(INS CHR] 


> 

44 


2 

Yes 

— 

45 

[Delete char] 

[DEL CHR] 



1 These characters cannot be generated by pressing the CTRL key and a 
non-ASCII key. If one of these characters follows CHR$(255) in an output 
to the keyboard, an error is reported (Error 131 Bad non-alphanumeric 
keycode.). 

2 Cannot generate this keycode from this keyboard. If this character is 
OUTPUT to the keyboard, an error is not reported. Instead, the system will 
perform as much of the indicated action as possible. 

4 These keys have no system meaning, and will BEEP if not trapped by ON 
KBD. 
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Char. 

Val. 

ITF 

Key 

98203 

Key 

Closure 

Key 

• 

46 

2 

2 


/ 

47 

(Delete line ] 

(DEL LN ) 

Yes 


48 

User 3 (re) 

(ED 

Yes 


49 

User 1 (fl) 

(HD 

Yes 


50 

User 1 (?D 

(ED 

Yes 


51 

User 1 (re) 

(ED 

Yes 


52 

User 1 QD 

(ED 

Yes 

5 

53 

User 1 (re) 

(ED 

Yes 

6 

54 

User 1 (re) 

(ED 

Yes 

7 

55 

User 1 (re) 

(HD 

Yes 

8 

56 

User 1 (re) 

(ED 

Yes 

9 

57 

User 2 (fl) 

(ED 

Yes 

: 

58 

System (Shift Kre) 4 

2 


$ 

59 

System (Shift f-fre) 4 

2 



2 Cannot generate this keycode from this keyboard. If this character is 
OUTPUT to the keyboard, an error is not reported. Instead, the system will 
perform as much of the indicated action as possible. 

3 This ITF key is located in the System Control Key Group just above the 
Numeric Keypad Group. Note that these keys have no labels on their keycaps; 
however, they do have labels on the BASIC keyboard overlay for the ITF 
keyboard. For information on the BASIC keyboard overlay for the ITF 
keyboard, read Using HP BASIC/WS 6.2 or Using HP BASIC/UX 6.2. 

4 These keys have no system meaning, and will BEEP if not trapped by ON 

KBD. 

3 also System (re] 
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7 also System (Shift j - (7IT) 
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Char. 

Val. 

ITF 

Key 

98203 

Key 

Closure 

Key 

< 

60 

s 

0 


= 

61 

Result 3 

(RESULTJ 


> 

62 

© 

GD 


? 

63 

Recall 3 6 

(RECALL) 


C 

64 

(Shift)- Recall 3 7 



A 

65 

System (m) 

(PRT ALL) 

Yes 

B 

66 


(BACK SPACE) 


C 

67 

System (f|) 

(CONTINUE) 


D 

68 

2 



E 

69 


(ENTER) 

Yes 

F 

70 

System (?6) 

(DISPLAY FCTNS) 

Yes 

G 

71 

(shiftXT) 

(shift>R) 


H 

72 

1 

(shIftKE) 


I 

73 

1 




1 These characters cannot be generated by pressing the CTRL key and a 
non-ASCII key. If one of these characters follows CHR$(255) in an output 
to the keyboard, an error is reported (Error 131 Bad non-alphanumeric 
keycode.). 

2 Cannot generate this keycode from this keyboard. If this character is 
OUTPUT to the keyboard, an error is not reported. Instead, the system will 
perform as much of the indicated action as possible. 

3 This ITF key is located in the System Control Key Group just above the 
Numeric Keypad Group. Note that these keys have no labels on their keycaps; 
however, they do have labels on the BASIC keyboard overlay for the ITF 
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keyboard. For information on the BASIC keyboard overlay for the ITF 
keyboard, read Using HP BASIC/WS 6.2 or Using HP BASIC/UX 6.2. 

®0r fReturn 1 
9 Also f Print 1 
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Char. 

Val. 

ITF 

Key 

98203 

Key 

Closure 

Key 

J 

74 

(Katakana) 2 

(Katakana) 2 


K 

75 

(Clear display) 

fCLR SCR) 

Yes 

L 

76 

Graphics 3 

(GRAPHICS) 

Yes 

M 

77 

Alpha 3 

(ALPHA) 

Yes 

N 

78 

Dump Graph 3 

(DUMP GRAPHICS) 

Yes 

H 

79 

Dump Alpha 3 9 

(DUMP ALPHA) 

Yes 

1 

80 

(Stop) 

'mm 

Yes 

II 

81 

l 

i 


H 

82 

System (f|) 


Yes 


83 

System (ft) 


Yes 


84 

(Shift}-® 

(shift)-® 

Yes 


85 

(Caps) 

(CAPS LOCK) 

Yes 


86 

0 

CD 

Yes 


1 These characters cannot be generated by pressing the CTRL key and a 
non-ASCII key. If one of these characters follows CHR$(255) in an output 
to the keyboard, an error is reported (Error 131 Bad non-alphanumeric 
keycode.). 

2 Cannot generate this keycode from this keyboard. If this character is 
OUTPUT to the keyboard, an error is not reported. Instead, the system will 
perform as much of the indicated action as possible. 
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Char. 

Val. 

ITF 

Key 

98203 

Key 

Closure 

Key 

W 

87 

(ShiftHA) 

(SHIFT Mil 

Yes 

X 

88 

2 

(EXECUTE) 

Yes 

w 

87 

(Shift)-® 

(shift KT) 

Yes 

X 

88 

2 

(EXECUTE) 

Yes 

mm 

89 

(Roman) 2 

(Roman) 2 

Yes 

mm 

90 

l 

l 


C 

91 

System (?5) 

(CLR TAB) 


\ 

92 

0 

2 

Yes 

] 

93 

System (Shift Hf5) 

(SET TAB) 


- 

94 


CD 

Yes 

- 

95 

System (Shift h(>) 

2 

Yes 

i 

96 

l 

1 


a 

97 

User 2 (?2) 


Yes 

b 

98 

User 2 (?3) 

(SHIFT Kidl 

Yes 


1 These characters cannot be generated by pressing the CTRL key and a 
non-ASCII key. If one of these characters follows CHR$(255) in an output 
to the keyboard, an error is reported (Error 131 Bad non-alphanumeric 
keycode.). 

2 Cannot generate this keycode from this keyboard. If this character is 
OUTPUT to the keyboard, an error is not reported. Instead, the system will 
perform as much of the indicated action as possible. 

4 These keys have no system meaning, and will BEEP if not trapped by ON 
KBD. 

5 These keys are also generated by the HP 46060A/B and HP 46095A (HP 
Mouse devices) buttons unless GRAPHICS INPUT IS is using them. 


4-36 Useful Tables 






















Char. 

Val. 

ITF 

Key 

98203 

Key 

Closure 

Key 

c 

99 

User 2 (77) 


Yes 

d 

100 

User 2 (f|) 

.. v ,\ ; : '• v: 

Yes 

e 

101 

User 2 (ft) 


Yes 

f 

102 

User 2 @ 


Yes 

g 

103 

User 2 (Ts) 

1 

Yes 

mm 

104 

User 3 (IT) 


Yes 

B 

105 

User 3 (f|) 


Yes 

B 

106 

User 3 (f|) 


Yes 

k 

107 

User 3 (m) 

2 

Yes 

1 

108 

User 3 (7|) 

2 

Yes 

m 

109 

User 3 (ftp 

2 

Yes 

n 

110 

User 3 (77) 

2 

Yes 

o 

111 

System (Shift HfT) 4 

2 


P 

112 

System (Shift HfT) 4 

2 



1 These characters cannot be generated by pressing the CTRL key and a 
non-ASCII key. If one of these characters follows CHR$(255) in an output 
to the keyboard, an error is reported (Error 131 Bad non-alphanumeric 
keycode.). 

2 Cannot generate this keycode from this keyboard. If this character is 
OUTPUT to the keyboard, an error is not reported. Instead, the system will 
perform as much of the indicated action as possible. 

4 These keys have no system meaning, and will BEEP if not trapped by ON 
KBD. 
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Char. 

Val. 

ITF 

Key 

98203 

Key 

Closure 

Key 

q 

113 

System (Shift}-© 4 

2 


r 

114 

System [Shift MfT) 4 

2 


s 

115 

User (siriftKfn 4 5 

2 


t 

116 

User (ShifO-(f2) 4 5 

2 


u 

117 

User (sm-03) 4 5 

2 


V 

118 

User [ Shift HfT) 4 

2 


w 

119 

User [Shift HfT) 4 

2 


X 

120 

User [ Shift HftT) 4 

2 


y 

121 

User [Shift HfF) 4 

2 


z 

122 

User (Shift 4 

2 


{ 

123 


2 

Yes 

1 

124 


2 

Yes 

> 

125 


2 

Yes 

- 

126 

1 

2 

Yes 

(box) 

127 

l 

1 



1 These characters cannot be generated by pressing the CTRL key and a 
non-ASCII key. If one of these characters follows CHR$(255) in an output 
to the keyboard, an error is reported (Error 131 Bad non-alphanumeric 
keycode.). 

2 Cannot generate this keycode from this keyboard. If this character is 
OUTPUT to the keyboard, an error is not reported. Instead, the system will 
perform as much of the indicated action as possible. 

4 These keys have no system meaning, and will BEEP if not trapped by ON 
KBD. 
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Glossary 


access capability 

See SRM password. 

angle mode 

The current units used for expressing angles. Either degrees or radians may 
be specified, using the DEG or RAD statements, respectively. The default 
at power-on and SCRATCH A is radians. 

A subprogram “inherits” the angle mode of the calling context. If the 
angle mode is changed in a subprogram, the mode of the calling context is 
restored when execution returns to the calling context. 

array 

A structured data type that can be of type REAL, INTEGER, COMPLEX, 
or string. Arrays are created with the DIM, REAL, INTEGER, 

COMPLEX, ALLOCATE, or COM statements. Arrays have 1 to 6 
dimensions; each dimension is allowed 32 767 elements. The lower and 
upper bounds for each dimension must fall in the range —32 767 (—32 768 
for ALLOCATE) thru +32 767, and the lower bound must not exceed the 
upper bound. The default lower bound is the OPTION BASE value; the 
OPTION BASE statement can be used to specify 0 or 1 as the default 
lower bound. The default OPTION BASE in every environment is zero. 

Each element in a string array is a string whose maximum length is 
specified in the declaring statement. The declared length of a string must 
be in the range 1 thru 32 767. 

To specify an entire array, the characters (*) are placed after the array 
name. To specify a single element of an array, subscripts are placed in 
parentheses after the array name. Each subscript must not be less than 
the current lower bound or greater than the current upper bound of the 
corresponding dimension. 


Glossary-1 





If an array is not explicitly dimensioned, it is implicitly given the number 
of dimensions used in its first occurrence, with an upper bound of 10. 
Undeclared strings have a default length of 18 bytes (18 ASCII characters). 

ASCII 

This is the acronym for “American Standard Code for Information 
Interchange”. It is a commonly used code for representing letters, numerals, 
punctuation, special characters, and control characters. A table of the 
characters in the ASCII set and their code values can be found in the back 
of this manual. 


bit 

This term comes from the words “binary digit”. A bit is a single digit in 
base 2 that must be either a 1 or a 0. 

byte 

A group of eight bits processed as a unit. 

command 

A statement that can be typed on the input line and executed (see 
“statement”). 

COMPLEX 

A complex number is an ordered pair (x,y) denoted by Mathematicians as: 

x + yi 

where: 

x is the real part of the complex number and y is the imaginary part of the 
complex number. The product yi represents the value obtained from: 
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Thus, this expression: 


y\f-t 


V—9 

could be written as 3 i. 

context 

An instance of an environment. A context consists of a specific instance of 
all data types and system parameters that may be accessed by a program at 
a specific point in its execution. Context changes occur when subprograms 
are invoked or exited. 

device selector 

A numeric expression used to specify the source or destination of an I/O 
operation. A device selector can be either an interface select code or a 
combination of an interface select code and an HP-IB primary address. To 
construct a device selector with a primary address, multiply the interface 
select code by 100 and add the primary address. For instance, a device 
selector that specifies the device at address 1 on interface select code 7 is 
701. The device at address 0 on interface select code 14 is 1400. Device 
selector 1516 selects interface select code 15 and primary address 16. 

Secondary addresses may be appended after a primary address by 
multiplying the device selector by 100 and adding the address. This may 
be repeated up to 6 times, adding a new secondary address each time. A 
device selector, once rounded, may contain a maximum of 15 digits. For 
example, 70502 selects interface 7, primary address 05, and secondary 
address 02. 

In BASIC/UX, a device selector may also be a window number in the range 
of 600 through 699. Note that the window being referenced must exist 
before it can accept output. 

When a device selector contains an odd number of digits, the leftmost digit 
is the interface select code. For an even number of digits, the leftmost two 
digits are the interface select code. 
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DFS 

This is the acronym for “DOS File System.” 

directory name 

A directory name specifies a directory of files on a hierarchically structured 
mass storage volume. Directory names follow the same rules as file names 
(see “file name”). 

display enhancement characters 

Display enhancement characters change the appearance of characters that 
follow. These characters do not occupy any space on the screen, nor do 
they produce any immediately visible effect. 

Globalized BASIC defines both one- and two-byte display enhancement 
characters. Refer to the globalization chapters of HP BASIC 6.2 Porting 
and Globalization for more information about two-byte characters. 

dyadic operator 

An operator that performs its operation with two expressions. It is placed 
between the two expressions. The following dyadic operators are available: 
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Dyadic 

Operator 

Operation 

+ 

REAL, COMPLEX or INTEGER addition 

- 

REAL, COMPLEX or INTEGER subtraction 

* 

REAL, COMPLEX or INTEGER multiplication 

/ 

REAL or COMPLEX division 1 

- 

REAL, COMPLEX or INTEGER exponentiation 1 

ft 

String concatenation 

DIV 

Gives the integer quotient of a division 

HOD 

Gives the remainder of a division 

MODULO 

Gives the remainder of a division, similar to MOD 

= 

Comparison for equality 

<> 

Comparison for inequality 

< 

Comparison for less than 

> 

Comparison for greater than 

<= 

Comparison for less than or equal to 

>= 

Comparison for greater than or equal to 

AND 

Logical AND 

OR 

Logical inclusive OR 

EXOR 

Logical exclusive OR 


INTEGER arguments are converted to REAL before any computation is 
done. 

file name 

A name used to identify a file. The length and characters allowed in a file 
name vary according to the format of the volume on which the file resides. 
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Note You can avoid most complexities and pitfalls by using only 

upper and lower case ASCII letters, digits, and the underline 
character in file names. This is particularly important if 
globalization is active. 


■ A file name on a Logical Interchange Format (LIF) volume may consist of 
from 1 to 10 characters, which may include all ASCII characters except 

“<”, and “|”. Spaces are ignored. 

■ A file name on a Hierarchical File System (HFS) volume may consist of 

from 1 to 14 characters, which may include all ASCII characters except 
“/”, “<”, and “|”. Spaces are ignored. 

■ A file name on a Shared Resource Manager (SRM or SRM/UX) volume 

may consist of from 1 to 16 characters, which may include all ASCII 
characters except “/”, “<”, “|”, and character 255. (Character 0, 

the null character, is also invalid for SRM/UX only.) Spaces are ignored. 

■ DFS file names follow the standard MS-DOS file name conventions. That 
is, a file name consists of from 1 to 8 characters, optionally followed by 

a period and an extension of from 1 to 3 characters. All alphanumeric 
characters (“A” through “Z”, “a” through “z”, and “0” through “9”) 
are valid in DFS file names and extensions. However, lower-case alpha 
characters are “case-folded” into upper-case characters. In addition, the 
following characters may be used: “$”, “&”, “#”, “%”, “!”, “(”, “)”, 

and 

Spaces may not be used in DFS file names or extensions. Also, the period 
is not valid, except for the period that separates the extension. Note that 
MS-DOS reserves certain file name extensions (“.COM”, “.SYS”, and 
“.EXE”) which should not be used for DFS file names. 


Note When WILDCARDS UX is enabled, the wildcard characters 

“?”, “*”, and “[” cannot be used explicitly in a filename unless 
preceded by the escape character specified in the WILDCARDS 
statement. When WILDCARDS DOS is enabled, the wildcard 
characters “?” and “*” cannot be used explicitly in a filename. 
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function 

A procedural call that returns a value. The call can be to a user-defined- 
function subprogram (such as FNInvert) or a machine-resident function 
(such as COS or EXP). The value returned by the function is used in place 
of the function call when evaluating the expression containing the function 
call. 

graphic display unit 

This is 1/100 of the shortest axis on the plotting device. Graphic display 
units are the same size on both the X and Y axes. Abbreviated “GDU”. 

graphics font 

The type of characters displayed by LABEL. These are also called “stroked 
fonts” or “vector fonts”. The characters are drawn by a graphics pen. 

hard clip limits 

These are the physical limits of the plotting device. 

HFS 

This is the acronym for “Hierarchical File System.” 

hierarchy 

When a numeric or string expression contains more than one operation, the 
order of operations is determined by a precedence system. Operations with 
the highest precedence are performed first. Multiple operations with the 
same precedence are performed left to right. The following tables show the 
hierarchy for numeric and string operations. 
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Math Hierarchy 


Precedence 

Operator 

Highest 

Parentheses: (may be used to force any order of 
operations) 


Functions: user-defined and machine-resident 


Exponentiation: ~ 


Multiplication and division: * / MOD DIV 

MODULO 


Addition, subtraction, monadic plus and minus: + 


Relational operators: =<><><=>= 


NOT 


AND 

Lowest 

OR EXOR 


String Hierarchy 


Precedence 

Operator 

Highest 

Parentheses 


Functions (user-defined and machine-resident) and 


substring operations 

Lowest 

Concatenation: & 


HP-15 

An HP character coding system used to represent two-byte characters. 
BASIC uses HP-15 to represent two-byte characters in memory. Two-byte 
characters are used by certain non-Roman languages, such as Japanese. 
(See also “two-byte characters”.) 
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IP-16 

An HP character coding system used to represent two-byte characters. 
Two-byte characters are used by certain non-Roman languages, such as 
Japanese. Many HP Asian language printers use HP-16 codes to print 
two-byte characters. (See also “two-byte characters”.) 

70 path 

A combination of firmware and hardware that can be used during the 
transfer of data to and from a BASIC program. Associated with an I/O 
path is a unique table that describes the I/O path. This association table 
uses 148 bytes and is referenced when an I/O path name is used. For 
further details, see the ASSIGN statement. 


IN 

An abbreviation for “HP BASIC for Instrument Control.” 

INTEGER 

A numeric data type stored internally in two bytes. Two’s-complement 
representation is used, giving a range of —32 768 thru +32 767. If a 
numeric variable is not explicitly declared as an INTEGER, it is a REAL. 

integer 

A number with no fractional part; a whole number. 

interface select code 

A numeric expression that selects an interface for an I/O operation. 
Interface select codes 1 thru 7 are reserved for internal interfaces. Interface 
select codes 8 thru 31 are used for external interfaces. The internal 
HP-IB interface with select code 7 can be specified in statements that are 
restricted to external devices. (Also see “device selector”.) 

keyword 

A group of uppercase ASCII letters that has a predefined meaning to the 
computer. Keywords may be typed using all lowercase or all uppercase 
letters. 

LIF 

This is the acronym for “Logical Interchange Format”. This HP standard 
defines the format of mass storage files and directories. It allows the 
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interchange of data between different machines. Series 200/300 files of type 
ASCII are LIF compatible. See “file name” for file name restrictions. 

LIF protect code 

A non-listable, two-character code kept with a file description in the 
directory of a LIF volume. It guards against accidental changes to an 
individual file. It may be any two characters, but must not contain a “>” 
since that is used to terminate the protect code. Blanks are trimmed from 
protect codes. When the result contains more than two characters, only the 
first two are used as the actual protect code. A protect code that is the nulj 
string (or all blanks) is interpreted as no protect code. 

literal 

A string constant. When quote marks are used to delimit a literal, those 
quote marks are not part of the literal. To include a quote mark in a 
literal, type two consecutive quote marks (except in response to a LINPUT 
statement). The drawings showing literal forms of specifiers (such as file 
specifiers) show the quote marks required to delimit the literal. 

localization binaries 

Binaries that allow BASIC to support the two-byte characters used by 
non-Roman languages, such as Japanese. These binaries are LANGUAGE, 
FONT, and INPUT. 

localized BASIC 

A version of BASIC that has been customized to support the native 
language of a specific country. If the language uses two-byte characters, you 
must load language specific LANGUAGE, FONT, and INPUT binaries. 

(See also “two-byte characters” and “localization binaries”.) 

logical pen 

See “pen”. 

monadic operator 

An operator that performs its operation with one expression. It is placed in 
front of the expression. The following monadic operators are available: 
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Monadic 

Operator 

Operation 

- 

Reverses the sign of an expression 

+ 

Identity operator 

NOT 

Logical complement 


ms us 

The acronym for “mass storage unit specifier”. This archaic term is no 
longer used, because: it is not descriptive of newer mass storage devices 
which may have multiple units or multiple volumes; and it is not an 
industry-standard term. (See also “volume specifier”.) 

msvs 

The acronym for “mass storage volume specifier”. (See also “volume 
specifier”.) 

name 

A name identifies one of the following: variable, line label, common block, 
I/O path, function, or subprogram. A name consists of one to fifteen 
characters. The first character must be an ASCII letter or one of the 
characters from CHR$(161) thru CHR$(254). The remaining characters, 
if any, can be ASCII letters, numerals, the underbar ( _ ), or national 
language characters CHR$(161) thru CHR$(254). Names may be typed 
using any combination of uppercase and lowercase letters, unless the name 
uses the same letters as a keyword. Conflicts with keywords are resolved by 
mixing the letter case in the name. (Also see “file name”, “directory name”, 
and “volume name”.) 

node address 

An integer from 0 through 63 that identifies an SRM device (such as a 
workstation or controller). 
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numeric expression 

An expression that evaluates to a number. 


~T 

monadic |_J 


operator 


numeric 

expression 


u 

dyadic 

n 

operator 


numeric 

expression 


numeric 

constont 


numeric variable 
name 



—(O 

1 

o- 

subscript 

-Kir 


numeric function 
keyword 


KD-4 parameter 


numeric 
I function name 




On 


parameter 




- 

string 

expression 

H 

comparison 

operator 

H 







string 

expression 


U/TN-d num^ic L/7\ 

v v y expression V'./ 
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Item 

Description 

monadic 

operator 

An operator that performs its operation on the expression 
immediately to its right: + - NOT 

dyadic operator 

An operator that performs its operation on the two 
expressions it is between: “ * / MOD DIV + - = <><><=>= 
AND OR EXOR MODULO 

numeric 

constant 

A numeric quantity whose value is expressed using 
numerals, decimal point, and optional exponent notation 

numeric 
variable name 

The name of a numeric variable or the name of a numeric 
array from which an element is extracted using subscripts 

subscript 

A numeric expression used to select an element of an array 
(see “array”) 

numeric 

function 

keyword 

A keyword that invokes a machine-resident function which 
returns a numeric value 

numeric 
function name 

The name of a user-defined function that returns a numeric 
value 

parameter 

A numeric expression, string expression, or I/O path name 
that is passed to a function 

comparison 

operator 

An operator that returns a 1 (true) or a 0 (false) based on 
the result of a relational test of the operands it separates: 
><<=>= = <> 


password 

See “SRM password”. 


All graphical objects are “drawn” using mathematical representations in 
the computer’s memory. This is done with the “logical pen”. The logical 
pen creates five classes of objects: lines, polygons, labels, axes, and label 
locations (label locations are actually the position of an object, rather than 
an object). 
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Before these objects can be viewed, they are acted upon by various 
transformation matrices, such as scaling and pivoting. No single 
transformation affects all the objects, and no object is affected by all the 
transformations. 

The output of the transformations is used to control the “physical pen”. 

The physical pen creates the image that you actually see on the plotter or 
CRT. Since the graphics statements used to create objects act directly upon 
the logical pen, and you can see only the output of the physical pen, the 
location of the logical pen may not always be readily discernible from what 
you see. 

The following table shows which transformations act upon which objects. 


Applicable Graphics Transformations 



Scaling 

PIVOT 

CSIZE 

LDIR 

PDIR 

Lines (generated by moves and draws) 

X 

X 



[4] 

Polygons and rectangles 

X 

X 



X 

Characters (generated by LABEL) 



X 

X 


Axes (generated by AXES and GRID) 

X 





Location of labels 

[1] 

[3] 


[2] 



x The starting point for labels drawn after lines or axes is affected by 
scaling. 

2 The starting point for labels drawn after other labels is affected by LDIR. 

3 The starting point for labels drawn after lines or axes is affected by 
PIVOT. 

4 RPLOT and IPLOT are affected by PDIR. 
permission 

A file-access permission on an HFS volume. See the PERMIT statement for 
details. 
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primary address 

A numeric expression in the range of 0 thru 31 that specifies an individual 
device on an interface which is capable of servicing more than one device. 
The HP-IB interface can service multiple devices. (Also see “device 
selector”.) 

program line 

A statement that is preceded by a line number (and an optional line label) 
and stored with the [enter 1 , [execute] , or fReturn ) key into a program (see 
“statement”). 

protect code 

See “LIF protect code”. 

raster font 

The type of characters displayed by PRINT and DISP. These characters are 
composed of a matrix of display pixels. Individual pixels are turned on or 
off to create the outline of a character. 

REAL 

A numeric data type that is stored internally in eight bytes using 
sign-and-magnitude binary representation. One bit is used for the number’s 
sign, 11 bits for a biased exponent (bias = 1023), and 52 bits for a 
mantissa. On all values except 0, there is an implied “1.” preceding the 
mantissa (this can be thought of as the 53rd bit). The range of REAL 
numbers is approximately: 

-1.797 693 134 862 32 E+308 thru -2.225 073 858 507 2 E-308,0, and 
+2.225 073 858 507 2 E-308 thru +1.797 693 134 862 32 E+308 

If a numeric variable is not explicitly declared as INTEGER or COMPLEX, 
it is REAL. 

record 

The records referred to in the Series 200/300 BASIC manuals are defined 
records. Defined records are the smallest unit of storage directly accessible 
on the mass storage media. The length of a record is different for various 
types of files. For ASCII files, the record length is the same as the sector 
size (256, 512, or 1024 bytes). For HP-UX files, defined records are always 1 
byte long. For BDAT files, the defined record length is determined when a 
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BDAT file is created by a CREATE BDAT statement. All records in a file 
are the same size. 

There is another type of record called a “physical record” (or sector) which 
is the unit of storage handled by the mass storage device and the operating 
system. Physical records contain 256, 512, or 1024 bytes and are not 
accessible to the user via standard BASIC statements. 

recursive 

The ability of a subprogram or function to call itself. 

row-major order 

The order of accessing an array in which the right-most subscript varies the 
fastest. 

secondary address 

A device-dependent command sent on HP-IB. It can be interpreted as a 
secondary address for the extended talker/listener functions or as part of a 
command sequence. (Also see “device selector”.) 

selector 

A numeric quantity used to identify or choose something from a number 
of possibilities. A selector is usually a numeric expression. For example: 
device selector is used to identify a device involved in a I/O operation, and 
pen selector is used to select a pen on a plotter. 

soft clip limits 

These are plotter clipping limits that are defined by the programmer. Lines 
drawn on a plotting device are drawn only inside the clipping limits. 

specifier 

A string used to identify a method for handling an I/O operation. A 
specifier is usually a string expression. For example: mass storage volume 
specifier selects the proper drivers for a mass storage volume, and plotter 
specifier chooses the protocol of a plotting device. 

SRM 

The acronym for Shared Resource Management. 
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SRM server 

The computer that controls access to the shared resources of the Shared 
Resource Management “file server” system. 

SRM server’s node address 

An integer in the range 0 through 63 that identifies the SRM server. 

SRM interface 

The term used to describe the Resource Management Interface resident in 
an SRM workstation computer (not the interface in the SRM server). 

SRM password 

A string of up to 16 characters that is used to protect a file on an SRM 
volume from being overwritten, purged, etc. It may be any 16 characters, 
but must not contain a “>” since that is used to terminate the password. 
Passwords are assigned by the PROTECT statement in BASIC or the 
Pascal Filer’s Access command. 

SRM volume name 

See “volume name”. 

SRM volume password 

See “volume password”. 

statement 

A keyword combined with any additional items that are allowed or required 
with that keyword. If a statement is placed after a line number and stored, 
it becomes a program line. If a statement is typed without a line number 
and executed, it is called a command. 

string 

A data type comprised of a contiguous series of characters. Strings require 
one byte of memory for each character of declared length, plus a two-byte 
length header. Characters are stored using an extended ASCII character 
set. The first character in a string is in position 1. The maximum length 
of a string is 32 767 characters. The current length of a string can never 
exceed the dimensioned length. 
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If a string is not explicitly dimensioned, it is implicitly dimensioned to 18 
bytes (18 ASCII characters). Each element in an implicitly dimensioned 
string array is dimensioned to 18 bytes (18 ASCII characters). 

When a string is empty, it has a current length of zero and is called a “null 
string”. All strings are null strings when they are declared. A null string 
can be represented as an empty literal (for example: A$="") or as one of 
three special cases of substring. The substrings that represent the null 
string are: 

1 . 

2 . 

3. 


Beginning position one greater than current length 
Ending position one less than beginning position 
Maximum substring length of zero 
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tring expression 

An expression that evaluates to a string. 


















Item 

Description 

literal 

A string constant composed of any characters 
available on the keyboard, including those 
generated with the ANY CHAR key. 

string 

variable 

name 

The name of a string variable or the name of a 
string array from which a string is extracted using 
subscripts 

subscript 

A numeric expression used to select an element of 
an array (see “array”) 

beginning 

position 

A numeric expression specifying the position of 
the first character in a substring (see “substring”) 

ending 

position 

A numeric expression specifying the position of 
the last character in a substring (see “substring”) 

substring 

length 

A numeric expression specifying the maximum 
number of characters to be included in a substring 
(see “substring”) 

string 

function 

keyword 

A keyword that invokes a machine-resident 
function which returns a string value. String 
function keywords always end with a dollar sign. 

string 

function 

name 

The name of a user-defined function that returns a 
string value 

parameter 

A numeric expression, string expression, or I/O 
path name that is is passed to a function 


subprogram 

Can be a CSUB, a SUB subprogram or a user-defined-function subprogram 
(DEF FN). The first line in a SUB subprogram is a SUB statement. The 
last line in a SUB subprogram (except for comments) is a SUBEND 
statement. The first line in a function subprogram is a DEF FN statement. 
The last line in a function (except for comments) is an FNEND statement. 
Subprograms must follow the END statement of the main program. 
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SUB and CSUB subprograms are invoked by CALL. Function subprograms 
are invoked by an FN function occurring in an expression. A function 
subprogram returns a value that replaces the occurrence of the FN function 
when the expression is evaluated. Subprograms may alter the values of 
parameters passed by reference or variables in COM. It is recommended 
that you do not let function subprograms alter values in that way. 

Invoking a subprogram establishes a new context. The new context remains 
in existence until the subprogram is properly exited or program execution is 
stopped. Subprograms can be recursive. 

subroutine 

A program segment accessed by a GOSUB statement and ended with a 
RETURN statement. 

substring 

A substring is a contiguous series of characters that comprises all or part of 
a string. Substrings may be accessed by specifying a beginning position, or 
a beginning position and an ending position, or a beginning position and a 
maximum substring length. 



The beginning position must be at least one and no greater than the 
current length plus one. When only the beginning position is specified, the 
substring includes all characters from that position to the current end of the 
string. 

The ending position must be no less than the beginning position minus 
one and no greater than the dimensioned length of the string. When both 
beginning and ending positions are specified, the substring includes all 
characters from the beginning position to the ending position or current end 
of the string, whichever is less. 
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The maximum substring length must be at least zero and no greater than 
one plus the dimensioned length of the string minus the beginning position. 
When a beginning position and substring length are specified, the substring 
starts at the beginning position and includes the number of characters 
specified by the substring length. If there are not enough characters 
available, the substring includes only the characters from the beginning 
position to the current end of the string. 

two-byte characters 

The characters used by certain non-Roman languages, such as Japanese, 
that are represented in computer memory as two bytes of data. 

two-byte language 

A human language that has an alphabet containing two-byte characters. 

vector font 

See “graphics font”. 

volume 

A named mass storage media, or portion thereof, which may contain several 
files. With BASIC, volumes are entities which are recognized by the disk 
controller. (This is in contrast to Workstation Pascal logical volumes, which 
are handled by the “Unitable” construct in the “TABLE” program; this 
program partitions a “hard” volume into several “logical” volumes by using 
byte offsets from sector number zero.) 

volume name (or label) 

A name used to identify a mass storage volume. The volume name is 
assigned to the volume at initialization, but may be changed on LIF and 
HFS volumes with PRINT LABEL (and read with CAT and READ 
LABEL). With SRM volumes, you may only change it at the SRM console. 

■ LIF volume names consist of 1 to 6 characters which may be any ASCII 

character except “/”, and “<”. 

■ HFS volume names may contain 1 to 6 characters, which may be any 
ASCII character except “/” and and “<”. Spaces are ignored. 

■ SRM volume names may contain 1 to 16 characters, which may be any 
ASCII character except “/” and “:” and “<”. Spaces are ignored. 
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volume password 

A “master” password on an SRM volume, assigned at initialization, that 
allows complete access to all files on that volume. SRM volume passwords 
consist of 1 to 16 characters. All ASCII characters except “>” are allowed. 
The volume password supercedes all access restrictions placed on files by 
the PROTECT statement in BASIC or the Pascal Filer’s Access command. 

volume specifier 

A string of information that identifies a mass storage volume. It consists 
of a device type (optional), device selector, unit number (optional; 
default=unit 0), and volume number (optional; default=volume number 0). 
Here are some examples: 

:CS80, 700 
700 

:,802, 0 
1400,0,0 

See MASS STORAGE IS for the complete syntax drawing. 
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